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PREFACE 
to the Second Edition 

In the months since this manual first appeared, many changes have 
occurred both in the system itself and in the way it is used. 

Perhaps most obviously, there have been additions, deletions, and 
modifications to the system and its software. It is these 
changes, of course, that caused the appearance of this revised 
manual . 

Second, the number of people spending an appreciable amount of 
time writing UNIX software has increased. Credit is due to 
L. L. Cherry, M. D. Mcllroy, L. E. McMahon, R. Morris, and 
J. F. Oss anna for their contributions. 

Finally, the number of UNIX installations has grown to 10, with 
more expected. None of these has exactly the same complement of 
hardware or software. Therefore, at any particular installation, 
it is quite possible that this manual will give inappropriate 
information. One area to watch concerns commands which deal with 
special files ( I/O devices) . Another is places which talk about 
such things as absolute core locations which are likely to vary 
with the memory configuration and existence of protection 
hardware. Also, not all installations have the latest versions 
of all the software. In particular, the assembler and loader 
have just undergone major reorganizations in anticipation of a 
UNIX for the PDP-11/45. 
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INTRODUCTION 



This manual gives descriptions of the publicly available features 
of UNIX. It provides neither a general overview (see "The UNIX 
Time-sharing System"* for that) nor details of the implementation 
of the system (which remain to be disclosed). 

Within the area it surveys, this manual attempts to be as com- 
plete and timely as possible. A conscious decision was made to 
describe each program in exactly the state it was in at the time 
its manual section was prepared. In particular, the desire to 
describe something as it should be, not as it is, was resisted. 
Inevitably, this means that many sections will soon be out of 
date. (The rate of change of the system is so great that a 
dismayingly large number of early sections had to be modified 
while the rest were being written. The unbounded effort required 
to stay up-to-date is best indicated by the fact that several of 
the programs described were written specifically to aid in 
preparation of this manual!) 

This manual is divided into seven sections: 

I. Commands 

II. System calls 

III. Subroutines 

IV. Special files 

V. File formats 

VI. User -maintained programs 

VII. Miscellaneous 

ODmmands are programs intended to be invoked directly by the 
user, in contradistinction to subroutines, which are intended to 
be called by the user's programs. Commands generally reside in 
directory /bin (for bin ary programs). This directory is searched 
automatically by the command line interpreter. Some programs 
classified as commands are located elsewhere; this fact is indi- 
cated in the appropriate sections. 

System calls are entries into the UNIX supervisor. In assembly 
language, they are coded with the use of the opcode "sys", a 
synonym for the trap instruction. 

A small assortment of subroutines is available; they are 
described in section III. The binary form of most of them is 
kept in the system library /usr/lib/liba.a. 

The special files^ sect ion IV discusses the characteristics of 
each system "file" which actually refers to an I/O device. 

The file formats section V documents the structure of particular 
kinds of files; for example, the form of the output of the loader 
and assembler is given. Excluded are files used by only one com- 
mand, for example the assembler's intermediate files. 
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User -maintained programs (section VI) aire not considered part of 
the UNIX system, and the principal reason for listing them is to 
indicate their existence without necessarily giving a complete 
description. The author should be consulted for information. 

The miscellaneous section (VII) gathers odds and ends. 

Each section consists of a number of independent entries of a 
page or so each. The name of the entry is in the upper right 
corner of its pages, its preparation date in the upper left. 
Entries within each section are alphabetized, it was thought 
better to avoid running page numbers, since it is hoped that the 
manual will be updated frequently. Therefore each entry is num- 
bered starting at page 1. 

All entries have a common format. 

The name section repeats the entry name and gives a very 
short description of its purpose. 

The synopsis summarizes the use of the program being 
described. A few conventions are used, particularly in the 
Commands section: 

Underlined words are considered literals, and are typed 
just as they appear. 

Square brackets ( [] ) around an argument indicate that the 
argument is optional. When an argument is given as 
"name", it always refers to a file name. 

Ellipses w ...'* are used to show that the previous 
argument-prototype may be repeated. 

A final convention is used by the commands themselves. 
An argument beginning with a minus sign M - w is often tak- 
en to mean some sort of flag argument even if it appears 
in a position where a file name could appear. Therefore, 
it is unwise to have files whose names begin with " , - ,, . 

The description section discusses in detail the subject at 
hand. 

The files section gives the names of files which are built 
into the program. 

A see also section gives pointers to related information. 

A diagnostics section discusses the diagnostics that may be 
produced. This section tends to be as terse as the diagnos- 
tics themselves. 

The bugs section gives known bugs and sometimes deficien- 
cies. Occasionally also the suggested fix is described. 
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The owner section gives the name of the person or persons to 
be consulted in case of difficulty. The rule has been that 
the last one to modify something owns it, so the owner is 
not necessarily the author. The owner's nicknames stand 
for: 

ken K. Thompson 

dmr D. M. Ritchie 

jfo J. F. Ossanna 

rhm R. Morris 

doug M. D. Mcllroy 

lent L. E. McMahon 

lie L. L. Cherry 

csr C. S. Roberts 

These nicknames also happen to be UNIX user ID's, so mes- 
sages may be transmitted by the mail command or, if the 
addressee is logged in, by write . 

At the beginning of this document is a table of contents, organ- 
ized by section and alphabetically within each section. There is 
also a permuted index derived from the table of contents. Within 
each index entry, the title of the writeup to which it refers is 
followed by the appropriate section number in parentheses. This 
fact is important because there is considerable name duplication 
among the sections, arising principally from commands which exist 
only to exercise a particular system call. 

This manual was prepared using the UNIX text editor _ed and the 
formatting program roff . 
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illegal instruction trap 

image file 

index 

information 

information 

inhibit interrupts 

inhibit quits 

initializer process 

init(Vll): initializer process 

instruction trap 

integer to ASCII 

integer 

interactively 

interpreter 

interrupts 

intr(Il): catch or inhibit interrupts 



trap 
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bj(Vl): the game of black 

kbd(VIl): map of TTY 37 

:(l): place 

form(l): generate form 

lpr(lV): 

ld(l): 

link(II): 

ln(l): 

ls(l): 
nlist(lll): read name 

dli(Vl): 

a.out(V): assembler and 

ld( I): link editor 

login(l): 

login(VIl): how to 

log(lll): 

utmp( V): 



hog (II): set 



m6(l): 
mt(l): save/restore files on 

mtO ( IV ) : 
mail ( I): send 



tap(I): 

man( I): run off 

uids(V): 

ascii(VII): 

kbd(VIl): 



mem(IV): core 



mesg(l): permit or deny 
tss(I): communicate with 
msh(VIl): 

chmod(l): change access 

chmod ( II ) : ch ange 

stty(ll): set 

stty(l): set typewriter 

gtty(ll): get typewriter 



istat(l): file status by i-n umber 

itoa(lll): convert integer to ASCII 

jack 

kbd(VIl): map of TTY 37 keyboard 

keyboard 

kill(il): destroy process 

label 

ld(I): link editor (loader) 

letter 

line printer 

link editor (loader) 

link to file 

link to file 

link(ll): link to file 

list contents of directory 

list 

ln(l): link to file 

load DEC binary paper tapes 

loader output 

(loader) 

log on to system 

log onto system 

logarithm base e 

logged-in user information 

log(lll): logarithm base e 

login(l): log on to system 

login(VIl): how to log onto system 

low-priority status 

lpr(iv): line printer 

ls(l): list contents of directory 

macro processor 

magtape 

magtape 

mail to another user 

mail(l): send mail to another user 

makdir(Jl): create directory 

man(I): run off manual section 

manipulate DECtape 

manual section 

map names to user ID's 

map of ASCII 

map of TTY 37 keyboard 

mdate(ll): set date modified of file 

mem(iv): core memory 

memory 

mesg(l): permit or deny messages 

mesg(lll): print string on typewriter 

messages 

MH-TSS (GCOS) 

mini Shell 

mkdir(l): create directory 

mode of files 

mode of file 

mode of typewriter 

modes 

mod e 
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mdate(ll): set date 

moo (VI): the game of 

mount ( I ) : 

mount (II) : 



mv(l): 
seek( II) : 



nlist(lll): read 

tty(l): find 

nm(l): print 

uids(V): map 

find (I): find file with given 

fork( II) : create 



od(l): 

man(l): run 

opr(l): print file 

login (VII): how to log 

close(ll): close 

fstat(II): status of 

open (II): 



cat( I) : concatenate 

assembler and loader 

ov(I): page 

chown ( I ) : change 

chown ( II ) : ch ange 

ov(l): 

type(l): print file 

dli(VI): load DEC binary 

dpt(Vl): read DEC ASCII 

ppt ( IV ) : punched 

passwd(V): 
mesg( I): 
ptx(Vl): 

:(D: 
seek(il): move read or write 

tell (II): find read or write 



chash(Vl): 

cal(Vl): 
echo( I): 



modified of file 

moo(VI): the game of MOO 

MOO 

mount detachable file system 

mount file system 

mount(l): mount detachable file system 

mount(ll): mount file system 

move or rename file 

move read or write pointer 

msh(VIl): mini Shell 

mt(l): save/restore files on magtape 

mtO ( IV ) : magt ape 

mv( I) : move or rename file 

m6(l): macroprocessor 

name list 

name of . terminal 

namelist 

names to user ID's 

name 

new process 

nlist(lll): read name list 

nm(l): print namelist 

nroff(l): format text for printing 

octal dump of file 

od(l): octal dump of file 

off manual section 

off-line 

onto syst em 

open file 

open file 

open file 

open(II): open file 

opr(l): print file off-line 

(or print) files 

output. ..a.out(v): 

overlay file print 

ov(l): page overlay file print 

owner of files 

owner of file 

page overlay file print 

page -by-page 

paper tapes 

paper tapes 

paper tape 

passwd(V): password file 

password file 

permit or deny messages 

permuted index 

place label 

pointer 

pointer 

ppt(IV): punched paper tape 

prepare symbol table 

pr(l): print file with headings 

print calendar 

print command arguments 
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opr(l): 

type(l): 

pr(I): 

cat(l): concatenate (or 

nm( I): 

mesg( III): 

ptime(HI): 

lpr(lV): line 

nroff(l): format text for 

roff(l): format text for 

ov(l): page overlay file 

bproc(VIl): boot 

rele(II): release 

fork(ll): create new 

init(VIl): initializer 

kill (II): destroy 

wait (II): wait for 

break(Il): set 

exec(ll): execute 

bc(Vl): compile B 

cc( I): compile c 

fc(i): compile Fortran 

tmg(Vl): compile tmgl 



PPt(lV): 



qsort(lll): 

quit( II) : catch or inhibit 

dpt(VI): 

read(ll): 

nlist(lll): 

seek(ll): move 

tell (II): find 

rele(ll): 

strip(l): remove symbols, 

tty0(iv): 

umount(l): dismount 

rmdir(l): 

rra(l): 

unlink( II): 

strip(l): 

mv( I) : move or 

salv(I): 

rew( I): 
rf ( IV ) : 

rkO(lV): 



print file off-line 

print file page-by-page 

print file with headings 

print) files 

print namelist 

print string on typewriter 

print time 

pr int er 

printing 

printing 

print 

procedure 

processor 

process 

process 

process 

process 

program break 

program file 

progr am 

program 

progr am 

progr am 

ptime(HI): print time 

ptx(Vl): permuted index 

punched paper tape 

putc(lll): write character or word 

qsort(lll): quicker sort 

quicker sort 

quit(ll): catch or inhibit quits 

quits 

read DEC ASCII paper tapes 

read file 

read name list 

read or write pointer 

read or write pointer 

read(II): read file 

release processor 

rele(ll): release processor 

relocation bits 

remote typewriter 

removable file system 

remove (delete) directory 

remove (delete) file 

remove (delete) file 

remove symbols, relocation bits 

rename file 

repair damaged file system 

rew(I): rewind DECtape 

rewind DECtape 

RF disk 

rf0(ivj: RF disk 

RK disk 

rkO(lV): RK disk 

rmdir(l): remove (delete) directory 

rm(l): remove (delete) file 
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sqrt(lll): square 
rpO ( IV ) : 

man ( I ) : 



mt(l): 
man( I) : run off manual 

mail( I): 

exit(l): end command 

mdate(ll): 

hog(II): 

stty(ll): 

break(II): 

stirae( II) : 

tabs(VIl): 

stty(l): 

setuid(ll): 

msh(VIl): mini 

f ptr ap ( III ) : float ing-po int 

sin(III): 



sort ( I ) : 

qsort ( III ) : quicker 

df(l): find free disk 

dpd(i): 

sqrt(lll): 



istat(l): file 

fstat(II): 

hog(ll): set low-priority 

stat( I): get file 

stat(Il): get file 

tabs(VIl): set tab 

salloc(HI): 

mesg(IIl): print 



sum( I): 

su(l): become 
basic(Vl): DEC 

chash(Vl): prepare 
db(l): 



roff(l): format text for printing 

root 

RP disk 

rpO(lV): RP disk 

run off manual section 

sarioc(IIl): storage allocator 

salv(l): repair damaged file system 

save/restore files on magtape 

section 

seek(ll): move read or write pointer 

send mail to another user 

sequence 

set date modified of file 

set low-priority status 

set mode of typewriter 

set program break 

set system time 

set tab stops on typewriter 

set typewriter modes 

set user ID 

setuid(ll): set user ID 

Shell 

sh(l): command interpreter 

simulator 

sine, cosine 

sin(III): sine, cosine 

sleep(ll): delay execution 

sort ASCII file 

sort (I): sort ASCII file 

sort 

space 

spawn data-phone daemon 

sqrt(lll): square root 

square root 

stat(l): get file status 

stat(ll): get file status 

status by i-number 

status of open file 

status 

status 

status 

stime(ll): set system time 

stops on typewriter 

storage allocator 

string on typewriter 

strip(l): remove symbols, relocation bits 

stty(l): set typewriter modes 

stty(il): set mode of typewriter 

su(l): become super-user 

sum file 

sum(l): sum file 

super-user 

supplied BASIC 

switch(lll): transfer depending on value 

symbol table 

symbolic debugger 
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strip(l): remove 

un(l): find undefined 

sync(ll): assure 

file system(V): file 

stime(ll): set 

file 

check consistency of file 

login(l): log on to 

login (VII): how to log onto 

mount detachable file 

mount(ll): mount file 

salv(l): repair damaged file 

dismount removable file 

umount(ll): dismount file 

who(l): who is on the 

tabs(VII): set 

chash(Vl): prepare symbol 

cref(Vl): cross-reference 



load DEC binary paper 

dpt(Vl): read DEC ASCII paper 

ppt(iv): punched paper 



tty(l): find name of 

exit(ll): 

ed( I) : 

nrof f ( I ) : format 

rof f ( I ) : format 

ttt(VI): the game of 

tm(l): get 

date(l): get date and 

time(Il): get 

ctime(lll): convert 

ptime(IIl): print 

stime(ll): set system 

tmg(Vl): compile 



switch( III): 

goto ( I ) : command 

cemt(II): catch EMT 

catch illegal instruction 



kbd(VIl): map of 



stty(l): set 



symbols, relocation bits 

symbols 

synchron iz at ion 

sync(Il): assure synchronization 

system format 

system time 

system(V): file system format 

system.. # check ( I): 

system 

system 

syst em . , . mount ( I ) : 

system 

system 

system. . .umount( I) : 

system 

system 

tab stops on typewriter 

table 

table 

tabs (VII): set tab stops on typewriter 

tacct(l): connect-time accounting 

tapes... dli(Vl): 

tapes 

tape 

tap(i): manipulate DECtape 

tap(V): DECtape format 

tapO(IV): DECtape 

tell (II): find read or write pointer 

terminal 

terminate execution 

text editor 

text for printing 

text for printing 

tic-tac-toe 

time information 

time of day 

time of year 

time to ASCII 

time (II): get time of year 

time 

time 

tmgl program 

tmg(Vl): compile tmgl program 

tm(l): get time information 

transfer depending on value 

transfer 

traps 

trap. ..ilgins(il): 

tss(l): communicate with MH-TSS (GCOS) 

ttt(VI): the game of tic-tac-toe 

TTY 37 keyboard 

tty(l): find name of terminal 

tty( IV ) : console typewriter 

ttyO( IV ) : remote typewr iter 

type(l): print file page-by-page 

typewriter modes 
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gtty(II): get 

getty(VIl): adapt to 

mesg(lll): print string on 

stty(ll): set mode of 

tabs(VIl): set tab stops on 

tty(iv): console 

ttyO(IV): remote 



un(l): find 



du(l): find disk 

uids(V): map names to 

getuid(ll): get 

setuid(ll): set 

utrap(V): logged-in 

mail(l): send mail to another 

write(l): write to another 

transfer depending on 

ds(I): 

wait( II): 



who ( I ) : 

gerts(HI): communicate 

find(l): find file 

pr(l): print file 

tss(i): communicate 

wc(l): get (English) 

putc(lll): write character or 

chdir( I) : change 

chdir(ll): change 

putc(IIl): 

write(ll): 

seek(ll): move read or 

tell(II): find read or 

write(l): 



tirae(ll): get time of 

dnO( IV): 

dpO ( IV ) : 

kbd(VIl): map of TTY 



typewriter mode 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

uids(V): map names to user ID's 

umount(l): dismount removable file system 

umount(ll): dismount file system 

undefined symbols 

un(l): find undefined symbols 

unlink(ll): remove (delete) file 

usage 

user ID's 

user ID 

user ID 

user information 

user 

user 

utmp(V): logged-in user information 

value.. .switch(III): 

verify directory hierarchy 

wait for process 

wait(Il): wait for process 

wc(I): get (English) word count 

who is on the system 

who(l): who is on the system 

with GCOS 

with given name 

with headings 

with MH-TSS (GCOS) 

word count 

word 

working directory 

working directory 

write character or word 

file 

point er 

pointer 

to another user 

write to another user 
write file 



write 

write 

write 

write 

write(l): 

write(ll) 

wtmp(V): accounting files 

year 

801 ACU 

201 Dataphone 

37 keyboard 
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(I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



— place a label 

[ label ] 

^ does nothing. Its only function is to place a 
Tabel for the goto command, ± is a command so 
the Shell doesn't have to be fixed to ignore 
lines with : 's. 



goto( I) 



dmr 
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ACCT (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



acct — login accounting 

acct [ wtmp ] 

acct produces a printout giving connect time and 
total number of connects for each user who has 
logged in during the life of the current wtmp 
file. A total is also produced. If no wtmp file 
is given, /tmp/wtmp is used. 

/tmp/wtmp 

init(VII), tacct(l), login(l), wtmp(V). 

"cannot open 'wtmp'" if argument is unreadable. 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



ar — archive 

ar key afile name. ... 

ar maintains groups of files combined into a sin- 
gle archive file. Its main use is to create and 
update library files as used by the loader. It 
can be used, though, for any similar purpose. 

key is one character from the set drtux . option- 
ally concatenated with v. afile is the archive 
file. The names are constituent files in the 
archive file. The meanings of the key characters 
are: 

d means delete the named files from the archive 
file. 

r means replace the named files in the archive 
file. If the archive file does not exist, r will 
create it. If the named files are not in the 
archive file, they are appended. 

t prints a table of contents of the archive file. 
If no names are given, all files in the archive 
are tabled. If names are given, only those files 
are tabled. 

u is similar to r except that only those files 
that have been modified are replaced. If no 
names are given, all files in the archive that 
have been modified will be replaced by the modi- 
fied version. 

x will extract the named files. If no names are 
given, all files in the archive are extracted. 
In neither case does x alter the archive file. 

v means verbose. Under the verbose option, jar 
gives a file-by-file description of the making of 
a new archive file from the old archive and the 
constituent files. The following abbreviations 
are used: 

c copy 
ja append 
d delete 
r replace 
x extract 

/tmp/vtm? temporary 

ld(l), archive(V) 

"Bad usage", "afile — M not in archive format" a 



cannot open temp file , 
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name — cannot open 
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"name — phase error", "name — cannot create"^ 
"no archive f ile", ^"cannot create archive file , 
"name — not found" . 

BUGS Option vt should be implemented as a table with 

more information. 

There should be a way to specify the placement of 
a new file in an archive. Currently, it is 
placed at the end. 

OWNER ken, drar 



- 2 - 



6/15/72 



AS (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



as 



as — assembler 

as [ - ] name . . . 

as assembles the concatenation of name., ... __ 
is based on the D EC-provided assembler PAL-11R 
[1], although it was coded locally. Therefore, 
only the differences will be recorded. 

If the optional first argument - is used, all 
undefined symbols in the assembly are treated as 
global. 

Character changes are: 



for 

# 



use 
* 



In as, the character ; is a logical new line; 
several operations may appear on one line if 
separated by ";" . Several new expression opera- 
tors have been provided: 



\> right shift (logical) 

\< left shift 

* multiplication 

\/ division 

% remainder (no longer means "register") 

! one's complement 

J] parentheses for grouping 

result has value of left, type of right 

For example location (relocatable) can be writ- 
ten "0~. ; another way to denote register 2 is 
2 rO . 



All of the preceding operators are binary; if a 
left^operand is missing, it is taken to be 0. 
The "l operator adds its left operand to the 
one's complement of its right operand. 

There is a conditional assembly operation code 
different from that of PAL-11R (whose condition- 
als are not provided): 

.if expression 
• • • 
. end if 

If the expression evaluates to non-zero^ the sec- 
tion of code between the ".if** and the A endif" 
is assembled; otherwise it is ignored. .if M s 
may be nested. 
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Temporary labels like those introduced by Knuth 
[2] may be employed. A temporary label is de- 
fined as follows: 

n: 

where n is a digit ... 9. Symbols of the form 
"nf" refer to the first label n:" following the 
use of the symbol; those of the form "nb" refer 
to the last n:". The same "n" may be used many 
times. Labels of this form are less taxing both 
on the imagination of the programmer and on the 
symbol table space of the assembler. 

The PAL-11R opcodes ".word", ",eot" and ".end" 
are redundant and are omitted. 

The symbols 

rO . . . r5 

frO ... fr5 (floating-point registers) 

sp 

pc 

ac 

mq 

div 

mul 

lsh 

ash 

nor 

csw 



are predefined with appropriate values. The svm- 
bol 'csw" refers to the console switches. " . . 
is the relocation constant and is added to each 
relocatable reference. On a PDP-11 with reloca- 
tion hardware, its value is 0; on most systems 
without protection, its value is 40000(8). 

The new opcode "sys" is used to specify system 
calls. Names for system calls are predefined. 
See section ( II) . 

The opcodes "bes" (branch on error set) and "bee" 
(branch on error clear) are defined to test the 
error status bit set on return from system calls. 

Strings of characters may be assembled in a way 
more convenient than PAL-11's ".ascii" operation 
(which is, therefore, omitted). Strings are 
included between the string quotes "<" and ">": 

<here is a string> 

Escape sequences exist to enter non graphic and 

- 2 - 
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other difficult characters. These sequences are 
also effective in single and double character 
constants introduced by single (') and double (") 
quotes respectively. 

use for 

\n newline (012) 

\0 NULL (000) 

\> > 

\t TAB (011 ) 

\a ACK (006) 

\r CR (015) 

\p ESC (033) 

\\ \ (134) 

as provides a primitive segmentation facility. 
There are three segments: text , data and bss . 
The text segment is ordinarily used for code. 
The data segment is provided for initialized but 
variable data. The bss segment cannot be ini- 
tialized, but symbols may be defined to lie 
within this segment. In the future, it is ex- 
pected that the text segment will be write- 
protected and sharable. Assembly begins in the 
text segment. The pseudo-operations 

.text 
.data 
.bss 

cause the assembler to switch to the text, data, 
or bss segment respectively. Segmentation is 
useful at present for two reasons: Non- 
initialized tables and variables, if placed in 
the bss segment, occupy no space in the output 
file. Also, alternative use of the text and data 
segments provides a primitive dual location- 
counter feature. 

In the output file, all text-segment information 
comes first, followed by all data-segment infor- 
mation, and finally bss information. Within each 
segment, information appears in the order writ- 
ten. 

Note: since nothing explicit can be assembled 
into the bss segment, the usual appearance of 
this segment is in the following style: 

.bss 

varl : .=,+2 

tabl : . = . + 100. 



That is, space is reserved but nothing explicit 
is placed in it. 
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As is evident from the example, it is legal to 
assign to the location counter " .**. f It is also 
permissible in segments other than H ,bss", The 
restriction is made, however, that the value so 
assigned must be defined in the first pass and it 
must be a value associated with the same segment 
as . . 

The pseudo-op 

.comm symbol, expression 

makes symbol an undefined global symbol, and • 
places the value of the expression in the value 
field of the symbol's definition. Thus the above 
declaration is equivalent to 

.globl symbol 

symbol = expression ~ symbol 

The treatment of such a symbol by the loader 
ld(l) is as follows: If another routine in the 
same load defines the symbol to be an ordinary 
text, data, bss, or absolute symbol, that defini- 
tion takes precedence and the symbol acts like a 
normal undefined external. If however no other 
routine defines the symbol, the loader defines it 
as an external bss-segment symbol and reserves n 
bytes after its location, where n is the value of 
the expression in the .comm operation. Thus 
".comm x, 100 M effectively declares x to be a com- 
mon region 100 bytes long. Note: all such de- 
clarations for the same symbol in various 
routines should request the same amount of space. 

The binary output of the assembler is placed on 
the file a. out" in the current directory, a. out 
also contains the symbol table from the assembly 
and relocation bits. The output of the assembler 
is executable immediately if the assembly was 
error-free and if there were no unresolved exter- 
nal references. The link editor Id may be used 
to combine several assembly outputs and resolve 
global symbols. 

The assembler does not produce a listing of the 
source program. This is not a serious drawback; 
the debugger db discussed below is sufficiently 
powerful to render a printed octal translation of 
the source unnecessary. 

On the last pages of this section is a list of 
all the assembler's built-in symbols. In the 
case of instructions, the addressing modes are as 
follows: 
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AS (I) 



FILES 



SEE ALSO 



D IAGNOST ICS 



BUGS 



src, dst 

r 

f src,fdst 

fr 

exp 



source, destination 

general register 

floating source, destination 

floating register 

expression 



The names of certain 11/45 opcodes are different 
from those in the 11/45 manual; some were changed 
to avoid conflict with EAE register names, others 
to draw analogies with existing 11/20 instruc- 
tions. 



/etc/as2 
/tmp/atm1? 
/trap/atm2? 
/tmp/atm3? 
a. out 



pass 2 of the 

temporary 

temporary 

temporary 

object 



assembler 



ld(l), nm(l), sh(l), un(l), db(l), a.out(V), 
fptrap(HI), [1] PAL-11R Assembler; DEC-11-ASDE- 
D, [2] Knuth, The Art of Computer Programming . 
Vol. I; Fundamental Algorithms. 

When an input file cannot be read, its name fol- 
lowed by a question mark is typed and assembly 
ceases. When syntactic or semantic errors occur, 
a single-character diagnostic is typed out to- 
gether with the line number and the file name in 
which it occurred. Errors in pass 1 cause can- 
cellation of pass 2. The possible errors are: 



) 
] 
< 
* 

• 

A 
B 
E 
F 
G 
I 
M 
O 
P 
R 
U 
X 



parentheses error 

parentheses error 

String not terminated properly 

Indirection ("*") used^ illegally 

Illegal assignment to "." 

error in Address 

Branch instruction is odd or too remote 

error in Expression 

error in local (V or "b") type symbol 

Garbage ( unknown ) charact er 

End of file inside an Jf 

Multiply defined symbol as label 

Odd — word quantity assembled at odd address 



Phase error — • 
Relocation error 
Undefined symbol 
syntax error 



different in pass 1 and 2 



OWNER 



Symbol table overflow is not checked. 

If " ." is moved backwards by an odd number of 

bytes, relocation bits are corrupted. 

dmr 
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Special variables: 



Register: 

rO 

r1 

r2 

r3 

r4 

r5 

sp 

pc 

frO 

fr1 

fr2 

fr3 

fr4 

fr5 

Eae & switches: 

csw 

div 

ac 

mq 

mul 

sc 

sr 

nor 

lsh 

ash 

System calls: 

exit 

fork 

read 

write 

open 

close 

wait 

creat 

link 

unlink 

exec 

chdir 

time 

makdir 

chmod 

chown 

break 

stat 

seek 



tell 

mount 

umount 

setuid 

getuid 

stime 

quit 

intr 

fstat 

cemt 

mdate 

stty 

gtty 

ilgins 

hog 

Double operand: 



mov 

movb 

cmp 

cmpb 

bit 

bitb 

bic 

bicb 

bis 

bisb 

add 

sub 



src A dst 



Branch: 



br 

bne 

beq 

bge 

bit 

bgt 

ble 

bpl 

bmi 

bhi 

bios 

bvc 

bvs 

bhis 

bee 

bec 

bio 

bes 

bes 



(= bec) 



(= bes) 
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Single operand: 



clr 


dst 


clrb 


ft 


com 




comb 




inc 




incb 




dec 




decb 


ft 


neg 




negb 




adc 




adcb 


tt 


sbc 




sbcb 


ft 


ror 




rorb 




rol 


ft 


rolb 




asr 




asrb 


tt 


asl 


tt 


aslb 




jmp 


tt 


swab 




tst 


src 


tstb 


src 



Miscellaneous: 

jsr r,dst 

. rts r 

sys exp 

Flag- setting: 

clc 
civ 
clz 
cln 
sec 
sev 
sez 
sen 

Floating point ops: 



(= trap) 



tstf 


fsrc 






movf 


fsrc,fr 


( = 


ldf ) 


movf 


fr, fdst 


( = 


stf ) 


movif 


src,fr 


( = 


ldcif ) 


movf i 


fr,dst 


( = 


stcfi) 


movof 


f src,fr 


( = 


ldcdf ) 


movfo 


fr f fdst 


( = 


stcfd) 


addf 


f src,f r 






subf 


f src,fr 






mulf 


f scr , fr 






divf 


f src,fr 






cmpf 


f src,f r 






modf 


f src, fr 






11/45 operations 






als 


src,r 


( = 


ash) 


alsc 


src t r 


( = 


ashc) 


mpy 


src,r 


( = 


mul ) 


dvd 


src,r 


( = 


div) 


xor 


src,r 






sxt 


dst 






mark 


exp 






sob 


r, exp 






Specials 








.byte 








.even 








• if 








.end if 








.globl 








.text 








.data 








,bss 








. co mm 









cfcc 




setf 




setd 




seti 




setl 




clrf 


fdst 


negf 


fdst 


absf 


fdst 



- 7 



3/15/72 BAS (I) 

NAME bas — basic 

SYNOPSIS bas [ f ile ] 

DESCRIPTION bas is a dialect of basic [1 ] . If a file argu- 

ment is provided, the file is used for input 
before the console is read. 

bas accepts lines of the form: 

statement 
integer statement 

Integer numbered statements (known as internal 
statements) are stored for later execution. They 
are stored in sorted ascending order. Non- 
numbered statements are immediately executed. 
The result of an immediate expression statement 
(that does not have '=' as its highest operator) 
is printed. 

Statements have the following syntax: ( expr is 
short for expression) 

expr 

The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above. 

done 

Return to system level. 

for name = expr expr statement 
for name = expr expr 

• • • 

next 



The for statement repetitively executes a 
statement (first form) or a group of state- 
ments (second form) under control of a 
named variable. The variable takes on the 
value of the first expression, then is 
incremented by one on each loop, not to 
exceed the value of the second expression. 

goto expr 

The expression is evaluated, truncated to 
an integer and execution goes to the 
corresponding integer numbered statment. 
If executed from immediate mode, the inter- 
nal statements are compiled first. 

if expr statement 

The statement is executed if the expression 
evaluates to non-zero. 

list [expr [expr]] 
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list is used to print out the stored inter- 
nal statements. If no arguments are given, 
all internal statements are printed. If 
one argument is given, only that internal 
statement is listed. if two arguments are 
given, all internal statements inclusively 
between the arguments are printed. 

print expr 

The expression is evaluated and printed. 

return expr 

The expression is evaluated and the result 
is passed back as the value of a function 
call. 

run 

The internal statements are compiled. The 
symbol table is re-initialized. The random 
number generator is re-set. Control is 
passed to the lowest numbered internal 
statement . 

Expressions have the following syntax: 

name 

A name is used to specify a variable. 
Names are composed of a letter ( # a' - 'z') 
followed by letters and digits. The first 
four characters of a name are significant. 

number 

A number is used to represent a constant 
value. A number is composed of digits, at 
most one decimal point ('./) and possibly a 
scale factor of the form e digits or e- 
digits. 

X expr X 

Parentheses are used to alter normal order 
of evaluation. 

expr op expr 

Common functions of two arguments are ab- 
breviated by the two arguments separated by 
an operator denoting the function. A com- 
plete list of operators is given below. 

expr £ [expr Q. expr ...]] X 

Functions of an arbitrary number of argu- 
ments can be called by an expression fol- 
lowed by the arguments in parentheses 
separated by commas. The expression evalu- 
ates to the line number of the entry of the 
function in the internally stored state- 
ments. This causes the internal statements 
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to be compiled. If the expression evalu- 
ates negative, a built in function is 
called. The list of built in functions 
appears below. 

name _[ expr [± expr . . . ] 2 

Arrays are not yet implemented. 

The following is the list of operators: 

= is the assignment operator. The left 
operand must be a name or an array element. 
The result is the right operand. Assign- 
ment binds right to left, all other opera- 
tors bind left to right. 

& | 

& (logical and) has result zero if either 
of its arguments are zero. It has result 
one if both its arguments are non-zero. J_ 
(logical or) has result zero if both of its 
arguments are zero. It has result one if 
either of its arguments are non-zero. 

<<=>>= == <> 

The relational operators (< less than, <= 
less than or equal, > greater than, >= 
greater than or equal, == equal to, <> not 
equal to) return one if their arguments are 
in the specified relation. They return 
zero otherwise. Relational operators at 
the same level extend as follows: a>b>c is 
the same as a>b&b>c. 

+ - 

Add and subtract. 



* 



/ 
Multiply and divide. 



Exponentiation. 

The following is a list of builtin functions: 

arg 

Arg(i) is the value of the ith actual 
parameter on the current level of function 
call. 

exp 

Exp(x) is the exponential function of x. 

log 

Log(x) is the logarithm base e of x. 
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sin 



Sin(x) is the sine of x (radians). 



cos 



Cos(x) is the cosine of x (radians). 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



atn 



Atn(x) is the arctangent of x. (Not imple- 
mented. ) 

rnd 

Rnd( ) is a uniformly distributed random 
number between zero and one. 

expr 

Expr( ) is the only form of program input. 
A line is read from the input and evaluated 
as an expression. The resultant value is 
returned. 

int 

Int(x) returns x truncated to an integer. 

/tmp/btm? temporary 

[1] DEC-11-AJPB-D 

Syntax errors cause the incorrect line to be 
typed with an underscore where the parse failed. 
All other diagnostics are self explanatory. 

Arrays [] are not yet implemented. In general, 
program sizes, recursion, etc are not checked, 
and cause trouble. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



cat — concatenate and print 

cat f ile^ . . . 

cat reads each file in sequence and writes it on 
the standard output stream. Thus: 

cat file 
is about the easiest way to print a file. Also: 

cat filel file2 >file3 

is about the easiest way to concatenate files. 

If no input file is given cat reads from the 
standard input file. 

pr(l), cp(l) 

none; if a file cannot be found it is ignored. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



cc — C compiler 

££ C ,z£ 3 sfile 1-a c ... ofile ... 

cc is the UNIX C compiler. It accepts three 
types of arguments: 

Arguments whose names end with ",c" are assumed 
to be C source programs; they are compiled, and 
the object program is left on the file sf ile. .o 
(i.e. M the file whose name M is (f that of the source 
with ".o" substituted for " .c" ). 

Other arguments (except for "-c") are assumed to 
be either loader flag arguments, or C-compatible 
object programs, typically produced by an earlier 
cc run, or perhaps libraries of C-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a. out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 



FILES 



f ile.c 

a. out 

c.tmp 

/sys/c/nc 

/usr/lib/crtO.o 

/usr /l ib/1 ibc . a 

/usr/lib/liba.a 



input file 

loaded output 

temporary (deleted) 

compiler 

runtime startoff 

built in functions, etc. 

system library 



SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



C reference manual (in preparation), bc(Vl) 
Diagnostics are intended to be self-explanatory. 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chdir — change working directory 

chdir directory 

directory becomes the new working directory. 

Because a new process is created to execute each 
command, chdir would be ineffective if it were 
written as a normal command. It is therefore 
recognized and executed by the Shell. 



sh(l) 

"Bad directory" if the directory cannot be 
changed to. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



check — file system consistency check 



FILES 

SEE ALSO 

D I AGNOST ICS 



BUGS 



check [ filesystem [ blockno. 



] ] 



OWNER 



check will examine a file system, build a bit map 
of used blocks, and compare this bit map against 
the bit map maintained on the file system. If 
the file system is not specified, a check of all 
of the normally mounted file systems is per- 
formed, output includes the number of files on 
the file system, the number of these that are 
'large', the number of used blocks, and the 
number of free blocks. 

/dev/rf?, /dev/rk?, /dev/rp? 

find(l), ds(l) 

Diagnostics are produced for blocks missing, 
duplicated, and bad block addresses. Diagnostics 
are also produced for block numbers passed as 
parameters. In each case, the block number, 
i-number, and block class (jl = inode, x indirect, 
f free) is printed. 

The checking process is two pass in nature. If 
checking is done on an active file system, ex- 
traneous diagnostics may occur. 

The swap space on the RF file system is not ac- 
counted for and will therefore show up as 'miss- 
ing'. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



chmod — change mode 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



chmod octal file 



The octal mode replaces the mode of each of the 
files. The mode is constructed from the OR of 
the following modes: 

01 write for non-owner 

02 read for non-owner 
04 write for owner 

10 read for owner 
20 executable 
40 set-UID 

Only the owner of a file may change its mode. 



stat(l), ls(l) 
- 9 - 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chown — change owner 

chown owner file. ... 

owner becomes the new owner of the files. The 
owner may be either a decimal UID or a name found 
in /etc/uids. 

Only the owner of a file is allowed to change the 
owner. It is illegal to change the owner of a 
file with the set-user-ID mode. 

/etc/uids 

stat( I) 

"who?** if owner cannot be found, "file?" if file 
cannot be found . 



ken, dmr 
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NAME cmp — compare two files 

SYNOPSIS cmp file., file 2 

DESCRIPTION The two files are compared for identical con- 

tents. Discrepancies are noted by giving the 
offset and the differing words. 

FILES 

SEE ALSO 

DIAGNOSTICS Messages are given for inability to open either 

argument, premature EOF on either argument, and 
incorrect usage. 

BUGS If the two files differ in length by one byte, 

the extra byte does not enter into the compari- 
son. 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

D IAGNOST ICS 

BUGS 



OWNER 



cp — copy 

cp f ile> fil©2 

The first file is opened for reading, the second 
created mode 17. Then the first is copied into 
the second. 



cat(l), pr(l) 

Error returns are checked at every system call, 
and appropriate diagnostics are produced. 

The second file should be created in the mode of 
the first. 

A directory convention as used in mv should be 
adopted for cp. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



date — print and set the date 

date [ mmddhhmm ] 

If no argument is given, the current date is 
printed to the second. If an argument is given, 
the current date is set. mm is the month number; 
dd is the day number in the month; hh is the hour 
number (24 hour system); mm is the minute number. 
For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



? if the argument is syntactically incorrect. 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



db — debug 

db [ core [ namelist ] ] [ - ] 

Unlike many debugging packages (including DEC's 
ODT, on which db is loosely based) db is not 
loaded as part of the core image which it is used 
to examine; instead it examines files. Typical- 
ly, the file will be either a core image produced 
after a fault or the binary output of the assem- 
bler. Core is the file being debugged; if omit- 
ted "core" is assumed, namelist is a file con- 
taining a symbol table. If it is omitted, the 
symbol table is obtained from the file being 
debugged, or if not there from a. out . If no 
appropriate name list file can be found, db can 
still be used but some of its symbolic facilities 
become unavailable. 

For the meaning of the optional third argument, 
see the last paragraph below. 

The format for most db requests is an address 
followed by a one character command. 

Addresses are expressions built up as follows: 

1 . A name has the value assigned to it when 
the input file was assembled. It may be 
relocatable or not depending on the use of 
the name during the assembly. 

2. An octal number is an absolute quantity 
with the appropriate value. 



3. An octal number immediately followed by 
is a relocatable quantity with the ap- 
propriate value. 



ft H 

r 



4. The symbol • indicates the current 
pointer of db. The current pointer is set 
by many db requests. 

5. Expressions separated by "+" or " " (blank) 
are expressions with value equal to the sum 
of the components. At most one of the com- 
ponents may be relocatable. 

6. Expressions separated by w - w form an ex- 
pression with value equal to the difference 
to the components. If the right component 
is relocatable, the left component must be 
relocatable. 

7. Expressions are evaluated left to right. 
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Names for registers are built in: 

rO ... r5 

sp 
pc 
ac 
mq 

These may be examined. Their values are deduced 
from the contents of the stack in a core image 
file. They are meaningless in a file that is not 
a core image. 

If no address is given for a command, the current 
address (also specified by " ." ) is assumed. In 
general, "• w points to the last word or byte 
printed by db . 

There are db commands for examining locations 
interpreted as octal numbers, machine instruc- 
tions, ASCII characters, and addresses. For 
numbers and characters, either bytes or words may 
be examined. The following commands are used to 
examine the specified file. 

/ The addressed word is printed in octal. 

\ The addressed byte is printed in octal. 

The addressed word is printed as two ASCII 
characters. 

* The addressed byte is printed as an ASCII 
character. 

* The addressed word is multiplied by 2, then 
printed in octal (used with B programs, 
whose addresses are word addresses). 

? The addressed word is interpreted as a 

machine instruction and a symbolic form of 
the instruction, including symbolic ad- 
dresses, is printed. Often, the result 
will appear exactly as it was written in 
the source program. 

& The addressed word is interpreted as a sym- 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset. 

<nl> (i. e., the character "new line") This 
command advances the current location 
counter w . w and prints the resulting loca- 
tion in the mode last specified by one of 
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the above requests. 

This character decrements w . w and prints 
the resulting location in the mode last 
selected one of the above requests. It is 
a converse to <nl>. 

% Exit. 

It is illegal for the word-oriented commands to 
have odd addresses. The incrementing and decre- 
menting of . " done by the <nl> and requests is 
by one or two depending on whether the last com- 
mand was word or byte oriented. 

The address portion of any of the above commands 
may be followed by a comma and then by an expres- 
sion. In this case that number of sequential 
words or bvtes specified by the expression is 
printed. ."is advanced so that it points at 
the last thing printed. 

There are two commands to interpret the value of 
expressions. 

= When preceded by an expression, the value 
of the expression is typed in octal. When 
not preceded by an expression, the value of 
**." is indicated. This command does not 
change the value of w . w . 

: An attempt is made to print the given ex- 
pression as a symbolic address. If the 
expression is relocatable, that symbol is 
found whose value is nearest that of the 
expression, and the symbol is typed, fol- 
lowed by a sign and the appropriate offset. 
If the value of the expression is absolute, 
a symbol with exactly the indicated value 
is sought and printed if found; if no 
matching symbol is discovered, the octal 
value of the expression is given. 

The following command may be used to patch the 
file being debugged. 

! This command must be preceded by an expres- 
sion. The value of the expression is 
stored at the location addressed by the 
current value of ".". The opcodes do not 
appear in the symbol table, so the user 
must assemble them by hand. 

The following command is used after a fault has 
caused a core image file to be produced. 
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$ causes the fault type and the contents of 
the general registers and several other 
registers to be printed both in octal and 
symbolic format. The values are as they 
were at the time of the fault. 

Db should not be used to examine special files, 
for example disks and tapes, since it reads one 
byte at a time. Use od(l) instead. 

For some purposes, it is important to know how 
addresses typed by the user correspond with loca- 
tions in the file being debugged. The mapping 
algorithm employed by db is non-trivial for two 
reasons: First, in an a. out file, there is a 
20(8) byte header which will not appear when the 
file is loaded into core for execution. There- 
fore, apparent location should correspond with 
actual file offset 20. Second, some systems 
cause a "squashed" core image to be written. In 
such a core image, addresses in the stack must be 
mapped according to the degree of squashing which 
has been employed. Db obeys the following rules: 

If exactly one argument is given, and if it ap- 
pears to be an a. out file, the 20-byte header is 
skipped during addressing, i.e., 20 is added to 
all addresses typed. As a consequence, the 
header can be examined beginning at location -20. 

If exactly one argument is given and if the file 
does not appear to be an a. out file, no mapping 
is done. 

If zero or two arguments are given, the mapping 
appropriate to a core image file is employed. 
This means that locations above the program break 
and below the stack effectively do not exist (and 
are not, in fact, recorded in the core file). 
Locations above the user's stack pointer are 
mapped, in looking at the core file, to the place 
where they are really stored. The per-process 
data kept by the system, which is stored in the 
last 512(10) bytes of the core file, can be ad- 
dressed at apparent locations 160000-160777. 

If one wants to examine a file which has an asso- 
ciated name list, but is not a core image file, 
the last argument "-" can be used (actually the 
only purpose of the last argument is to make the 
number of arguments not equal to two). This 
feature is used most frequently in examining the 
memory file /dev/mem. 

FILES 
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SEE ALSO as(l), core(V), a,out(V), od(l) 

DIAGNOSTICS "File not found^if the first argument cannot be 

read; otherwise "?" . 

BUGS The "~" request always decrements "." by 2, even 

in byte mode* 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



dc — desk calculator 



dc 



dc is an arbitrary precision integer arithmetic 
package. The overall structure of dc is a stack- 
ing (reverse Polish) calculator. The following 
constructions are recognized by the calculator: 

number 

The value of the number is pushed on the 
stack. If the number starts with a zero, it 
is taken to be octal, otherwise it is decimal. 

± r * L 1 

The top two values on the stack are added (+), 
subtracted (-), multiplied (*), divided (/), 
or remaindered (%). The two entries are 
poppped off of the stack, the result is pushed 
on the stack in their place. 



sx 



lx 



The top of the stack is popped and stored into 
a register named x, where x may be any charac- 
ter. 



The value in register x is pushed on the 
stack. The register x is not altered. 



The top value on the stack is pushed on the 
stack. Thus the top value is duplicated. 



The top value on the stack is printed in de- 
cimal. The top value remains unchanged. 



All values on the stack are popped off and 
printed in decimal. 



exits the program 



treats the top element of the stack as a char- 
acter string and executes it as a string of dc 
commands 



interprets the rest of the line as a UNIX com- 
mand. 



All values on the stack are popped. 
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nk 



A scale factor of 10 n is set for all subse- 
quent multiplication and division. 



new-line 
space 

ignored. 

An example to calculate the monthly, weekly and 
hourly rates for a s10 f 000/year salary. 



10000 

100* 

dsa 

12/ 

la52/ 

d10* 

375/ 

f 

(3) 512 

(2) 19230 

(1 ) 83333 



(now in cents) 
(non-destructive store) 
(pennies per month) 
(pennies per week) 
(deci-pennies per week) 
(pennies per hour) 
(print all results) 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



OWNER 



(x) ? for unrecognized character x. 

(x) ? for not enough elements on the stack to do 

what was asked. 

"out of space" when the free list is exhausted. 

f is not implemented 
% is not implemented 

rhm 
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NAME df — disk free 

SYNOPSIS df [ filesystem ] 

DESCRIPTION df prints out the number of free blocks available 

on a file system. If the file system is unspeci- 
fied, the free space on all of the normally 
mounted file systems is printed. 

FILES /dev/rf? f /dev/rk?, /dev/rp? 

SEE ALSO check ( I) 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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NAME dpd — spawn data phone daemon 

SYNOPSIS /etc/dpd 

DESCRIPTION dpd is the 201 data phone daemon. It is designed 

to submit jobs to the Honeywell 6070 computer via 
the gerts interface. 

dpd uses the directory /usr/dpd . The file lock 
in that directory is used to prevent two daemons 
from becoming active. After the daemon has suc- 
cessfully set the lock, it forks and the main 
path exits, thus spawning the daemon, /usr/dpd 
is scanned for any file beginning with df . Each 
such file is submitted as a job. Each line of a 
job file must begin with a key character to 
specify what to do with the remainder of the line 

S directs dpd to generate a unique snumb card. 
This card is generated by incrementing the 
first word of the file /usr/dpd/snumb and con- 
verting that to decimal concatenated with the 
station ID. 

L specifies that the remainder of the line is 
to be sent as a literal. 

B specifies that the rest of the line is a 
file name. That file is to be sent as binary 
cards. 

F is the same as B except the file is prepend- 
ed with a form feed. 

U specifies that the rest of the line is a 
file name. After the job has been transmit- 
ted, the file is unlinked. 

Any error encountered will cause the daemon to 
drop the call, wait up to 20 minutes and start 
over. This means that an improperly constructed 
df file may cause the same job to be submitted 
every 20 minutes. 

While waiting, the daemon checks to see that the 
lock file still exists. If the lock is gone, the 
daemon will exit. 

FILES /dev/dnO, /dev/dp0 f /usr/dpd/* 

SEE ALSO opr(l) 

DIAGNOSTICS 

BUGS 
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OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUSS 



OWNER 



ds — directory consistency check 

ds [ output ] 

ds will walk the directory tree from the root 
keeping a list of every file encountered. The 
second pass will read the i-list and compare the 
number of links there with the actual number 
found. All discrepancies are noted. 

If an argument is given, a complete printout of 
file names by i-n umber is output on the argument. 

/, /dev/rkO, /tmp/dstmp 

check ( I) 

incon si st ent i-numb er s 

the root is noted as inconsistent due to the fact 
that ■£ exists in no directory. (Its i-number is 
41.) 

ds should take an alternate file system argument, 
ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



dsw — delete interactively 

dsw [ directory ] 

For each file in the given directory [," •" if not 
specified) dsw types its^name. If y is typed, 
the file is deleted; if "x", dsw exits; if any- 
thing else, the file is not removed. 



rm( I) 

The name "dsw" is a carryover from the ancient 
past. Its etymology is amusing but the name is 
nonetheless ill-advised. 

dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



du — summarize disk usage 

du [ ^s ] [ ^a ] [ name ... ] 

du gives the number of blocks contained in all 

files and (recursively) directories within each 

specified directory or file name . If name is 
missing, x is used. 

The optional argument ^s causes only the grand 
total to be given. The optional argument ^a 
causes an entry to be generated for each file. 
Absence of either causes an entry to be generated 
for each directory only. 

A file which has two links to it is only counted 
once. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



Non-directories given as 
option) are not listed. 



arguments (not under -a 



Removable file systems do not work correctly 
since i-numbers may be repeated while the 
corresponding files are distinct. Du should 
maintain an i-n umber list per root directory 
encountered. 



OWNER 



dmr 
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NAME echo — echo arguments 

SYNOPSIS echo [ arg 1 ... ] 

DESCRIPTION echo writes all its arguments in order as a line 

on the standard output file. It is mainly useful 
for producing diagnostics in command files, 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER doug 
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NAME 

SYNOPSIS 

DESCRIPTION 



ed — editor 

ed [ name ] 

ed is the standard text editor. 

If the optional argument is given, ed simulates 
an e command on the named file; that is to say, 
the file is read into ed's buffer so that it can 
be edited. 

ed operates on a copy of any file it is editing; 
changes made in the copy have no effect on the 
file until an explicit write (w) command is 
given. The copy of the text being edited resides 
in a temporary file called the buffer . There is 
only one buffer. 

Commands to ed have a simple and regular 
structure: zero or more addresses followed by a 
single character command , possibly followed by 
parameters to the command. These addresses 
specify one or more lines in the buffer. Every 
command which requires addresses has default 
addresses, so that the addresses can often be 
omitted. 

In general only one command may appear on a line. 
Certain commands allow the input of text. This 
text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said 
to be in input mode . In this mode, no commands 
are recognized; all input is merely collected. 
Input mode is left by typing a period ( . ) alone 
at the beginning of a line. 

ed supports a limited form of regular expression 
notation. A regular expression is an expression 
which specifies a set of strings of characters. 
A member of this set of strings is said to be 
matched by the regular expression. The regular 
expressions allowed by ed are constructed as 
follows: 

1. An ordinary character (not one of those 
discussed below) is a regular expression 
and matches that character. 

2. A circumflex (~) at the beginning of a reg- 
ular expression matches the null character 
at the beginning of a line. 

3. A currency symbol ($) at the end of a regu- 
lar expression matches the null character 
at the end of a line. 
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4. A period ( . ) matches any character but a 
new-line character. 

5. A regular expression followed by an aster- 
isk (*) matches any number of adjacent 
occurrences (including zero) of the regular 
expression it follows, 

6. A string of characters enclosed in square 
brackets ( [] ) matches any character in the 
string but no others. If, however, the 
first character of the string is a circum- 
flex (~) the regular expression matches any 
character but new-line and the characters 
in the string. 

7. The concatenation of regular expressions is 
a regular expression which matches the con- 
catenation of the strings matched by the 
components of the regular expression. 

8. The null regular expression standing alone 
is equivalent to the last regular expres- 
sion encountered. 

Regular expressions are used in addresses to 
specify lines and in one command (s, see below) 
to specify a portion of a line which is to be 
replaced. 

If it is desired to use one of the regular ex- 
pression metacharacters as an ordinary character, 
that character may be preceded by "\". This also 
applies to the character bounding the regular 
expression (often n /" ) and to **\ itself. 

Addresses are constructed as follows. To under- 
stand addressing in ed it is necessary to know 
that at any time there is a current line . Gen- 
erally speaking, the current line is the last 
line affected by a command; however, the exact 
effect on the current line by each command is 
discussed under the description of the command. 

1. The character ". M addresses the current 
line. 

2. The character w ~" addresses the line im- 
mediately before the current line. 

3. The character "$ w addresses the last line 
of the buffer. 

4. A decimal number n addresses the nth line 
of the buffer. 
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6. A regular expression enclosed in slashes 
" /" addresses the first line found by 
searching toward the end of the buffer and 
stopping at the first line containing a 
string matching the regular expression. If 
necessary the search wraps around to the 
beginning of the buffer. 

5. A regular expression enclosed in queries 
?" addresses the first line found by 
searching toward the beginning of the 
buffer and stopping at the first line found 
containing a string matching the regular 
expression. If necessary the search wraps 
around to the end of the buffer. 



tt ti 



7. An address followed by a plus sign + or a 
minus sign "-" followed by a decimal number 
specifies that address plus (resp. minus) 
the indicated number of lines. The plus 
sign may be omitted. 

8. M 'x" addresses the line associated (marked) 
with the mark name character x" which must 
be a printable character. Lines may be 
marked with the \" command described 
below. 

Commands may require zero, one, or two addresses. 
Commands which require no addresses regard the 
presence of an address as an error. Commands 
which accept one or two addresses assume default 
addresses when insufficient are given. If more 
addresses are given than such a command requires, 
the last one or two (depending on what is accept- 
ed) are used. 

Addresses are separated from each other typically 
by a comma (,). They may also be separated by it a f 
semicolon (;). In this case the current line 
is set to the the previous address before the 
next address is interpreted. This feature can be 
used to determine the starting^line for forward 
and backward searches (V, M ? w ). The second 
address of any two-address sequence must 
correspond to a line following the line 
corresponding to the first address. 

In the following list of ed commands, the default 
addresses are shown in parentheses. The 
parentheses are not part of the address, but are 
used to show that the given addresses are the 
default. 

As mentioned, it is generally illegal for more 
than one command to appear on a line. However, 
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any command may be suffixed by p (for print ). 
In that case, the current line is printed after 
the command is complete. 

(.)a 
<text> 

• 

The append command reads the given text and 
appends it after the addressed line, 
is left on the last line input, if there 
were any A otherwise at the addressed line. 
Address o" is legal for this command; text 
is placed at the beginning of the buffer. 

( . , . )c 
<text> 

• 

The change command deletes the addressed 
lines, then accepts input text which re- 
places these lines. " ." is left at the 
last line input; if there were none, it is 
left at the first line not changed. 

The delete command deletes the addressed 
lines from the buffer. The line originally 
after the last line deleted becomes the 
current line; if the lines deleted were 
originally at the end, the new last line 
becomes the current line. 

e filename 

The edit command causes the entire contents 
of the buffer to be deleted^ and then the 
named file to be read in. ."is set to 
the last line of the buffer. The number of 
characters read is typed, "filename" is 
remembered for possible use as a default 
file name in a subsequent r or w command. 

f filename 

The filename command prints the currently 
remembered file name. If "filename" is 
given, the currently remembered file name 
is changed to "filename". 

( 1 i$ )g/regular express ion/ command list 

In the global command, the first step is to 
mark every line which matches the given 
regular expression. Then for every such 
line, w the given command list is executed 
with "." initially set to that line. A 
single command or the first of multiple 
commands appears on the same line with the 
global command. All lines of a multi-line 
list except the last line must be ended 
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with \ . a, jl, and c commands and associ- 
ated input are permitted; the " ." terminat- 
ing input mode may be omitted if it would 
be on the last line of the command list. 
The (global) commands, 2. an ^ 2£> are not 
permitted in the command list, 

(.)i 
<text> 

• 

This command J.nserts the given text before 
the addressed"! ine. "•" is left at the 
last line input; if there were none, at the 
addressed line. This command differs from 
the a command only in the placement of the 
text. 

(.)kx 

The mark command associates or marks the 
addressed line with the single character 
mark name "x**. The 'ten most recftrt. mark 
names are remembered. The current mark 
names may be printed with the n command. 

(.,.)1 

The list command prints the addressed lines 
in an unambiguous way. Non-printing char- 
acters are ov,er-struck as follows: 
char prints 



bs 


V , 


tab 


> 


ret 


< 


SI 


i 


SO 


e 



All characters preceded by a prefix (ESC) 
character are printed over-struck with 
without the prefix. Long lines are folded 
with the sequence \newline. 

( • , . )mA 

The move command will reposition the ad- 
dressed lines after the line addressed by 
V, The line originally after the last 
line moved becomes the current line; if the 
lines moved were originally at the end, the 
new last line becomes the current line. 

n 

The marknames command will print the 
current mark names. 

(•••)P 

The jarint command prints the addressed 
lines. ". w is left at the last line print- 
ed. The 2 command may be placed on the 
same line after any command. 
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The cjuit command causes ed to exit. No 
automatic write of a file is done, 

($)r filename 

The read command reads in the given file 
after the addressed line. If no file name 
is given, the remembered file name, if any, 
is used (see e and f commands). The remem- 
bered file name is not changed unless 
"filename** is the f| very first file name men- 
tioned. Address "o" is legal for r and 
causes the file to be read at the beginning 
of the buffer. If the read is successful, 
the number of characters read is typed. 
*'.*' is left at the last line read in from 
the file. 

( . , . )s/regular expression/replacement/ or, 
( • , . ) s/regular expression/replacement/g 

The substitute command searches each ad- 
dressed line for an occurrence of the 
specified regular expression. On each line 
in which a match is found, all matched 
strings are replaced by the replacement 
specified, if the global replacement indi- 
cator *'g** appears after the command. If 
the global indicator does not appear, only 
the first occurrence of the matched string 
is replaced. It is an error for the sub- 
stitution to fail on all addressed lines. 
Any character other than space or new-line 
may be used instead of **/'* to delimit the 
regular expression and the replacement. 
**. is left at the last line substituted. 



t« tt 



The ampersand & appearing in the replace- 
ment is replaced by the regular expression 
that was matched. The special meaning of 
**&" in this context may be suppressed by 
preceding it by **\**. 

( 1 ,$ )v/regular expression/command list 

This command is the same as the cjlobal com- 
mand except that the command list is exe- 
cuted with *' ." initially set to every line 
except those matching the regular expres- 
sion 

( 1 ,$ )w filename 

The write command writes the addressed 
lines onto the given file. If the file 
does not exist, it is created mode 17 
(readable and writeable by everyone). The 
remembered file name is not changed unless 
"filename** is the very first file name 
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mentioned. If no file name is given, the 

remembered file name A if any, is used (see 

e and f commands). ." is unchanged. If 

the command is successful, the number of 
characters written is typed. 

($) = 

The line #i number of the addressed line is 
typed. *' ." is unchanged by this command. 

I UNIX command 

The remainder of the line after the " !*' is 
sent to UNIX to be interpreted as a com- 
mand. "." is unchanged. 

( .+1 )<newline> 

An address alone on a line causes that line 
to be printed. A blank line alone is 
equivalent to " ,+1p"; it is useful for 
stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed 
will print a ?** and return to its command level. 

If invoiced with the command name '-', (see init ) 
ed will sicp^on with the message "Editing system** 
and print *** as the command level prompt charac- 
ter. 

Ed has size limitations on the maximum number of 
lines that can be edited, and on the maximum 
number of characters in a line, in a global 's 
command list, and in a remembered file name. 
These limitations vary with the physical core 
size of the PDP11 computer on which ed is being 
used. The range of limiting sizes for the above 
mentioned items is; 1300 - 4000 lines per file, 
256 - 512 characters per line, 63 - 256 charac- 
ters per global command list, and 64 characters 
per file name. 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



/tmp/etra? 
/etc/msh 



temporary 

to implement the 



"!" 



command 



? for any error 



ken, dmr, jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



exit 



exit 



terminate command file 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



exit performs a seek to the end of its standard 
input file. Thus, if it is invoked inside a file 
of commands, upon return from exit the shell will 
discover an end-of-file and terminate. 



if(l), goto(l), sh(l) 



dmr 



- 1 - 



3/15/72 



FC (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



fc — fortran compiler 

fc [ j^c ] sfile 1JL f . .. ofile ... 

fc is the UNIX Fortran compiler. It accepts 
three types of arguments: 



Arguments whose names end with 
to be Fortran source programs; 
and the object program is left 
sfile, .o (i.e. the file whose 



.f are assumed 
they are compiled, 
on the file 
name is that of 



the source with ".o" substituted for M .f M ). 

Other arguments (except for ""-c*" ) are assumed to 
be either loader flags, or object programs, typi- 
cally produced by an earlier fc run, or perhaps 
libraries of Fortran-compatible routines. These 
programs, together with the results of any compi- 
lations specified, are loaded (in the order 
given) to produce an executable program with name 
a. out . 

The " -c"* argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 

The following is a list of differences between fc 
and ANSI standard Fortran (also see the BUGS 
section): 

1. Arbitrary combination of types is allowed in 
expressions. Not all combinations are expect- 
ed to be supported at runtime. All of the 
normal conversions involving integer, real, 
double precision and complex are allowed. 

2. The 'standard' implicit statement is recog- 
nized. 

3. The types doublecomplex, logical* 1, integer*2 
and real*8 (doubleprecision ) are supported. 

4. & as the first character of a line signals a 
continuation card. 

5. c as the first character of a line signals a 
comment . 

6. All keywords are recognized in lower case. 

7. The notion of 'column 7' is not implemented. 

8. G- format input is free form — leading blanks 
are ignored, the first blank after the start 
of the number terminates the field. 
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9. A comma in any numeric or logical input field 
terminates the field. 

10. There is no carriage control on output. 

In I/O statements, only unit numbers 0-19 are 
supported. Unit number nn corresponds to file 
"fortnn:" (e.g. unit 9 is file "fort 09" ). For 
input, the file must exist; for output, it will 
be created. 

FILES file.f input file 

a. out loaded output 

f.tmp[l23] temporary (deleted) 

/usr/fort/f c[1 234] compilation phases 

/usr/lib/frO.o runtime start off 

/usr/lib/f ilib.a interpreter library 

/usr/lib/libf .a built in functions, etc. 

/usr/lib/liba.a system library 

SEE ALSO ANSI standard 

DIAGNOSTICS Oompile-time diagnostics are given by number. If 

the source code is available, it is printed with 
an underline at the current character pointer. 
Errors possible are: 

1 statement too long 

2 syntax error in type statement 

3 redeclaration 

4 missing ( in array declarator 

5 syntax error in dimension statement 

6 inappropriate or gratuitous array de- 
clarator 

7 syntax error in subscript bound 

8 illegal character 

9 common variable is a parameter or already 
in common 

10 common syntax error 

11 subroutine/blockdata/f unction not first 
statement 

12 subroutine/function syntax error 

13 block data syntax error 

14 redeclaration in external 

15 external syntax error 

16 implicit syntax error 

17 subscript on non-array 

18 incorrect subscript count 

19 subscript out of range 

20 subscript syntax error 

23 equivalence inconsistency 

24 equivalence syntax error 

2 5 separate common blocks equivalenced 

26 common block illegally extended by 
equivalence 

27 common inconsistency created by 
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equivalence 

2 9 ( ) imbalance in expression 

30 expression syntax error 

31 illegal variable in equivalence 
33 non array/function used with 

subscripts/ arguments 

35 goto syntax error 

37 illegal return 

38 continue, return, stop, call, end, or 
pause syntax error 

39 assign syntax error 

40 if syntax error 

41 I/O syntax error 

42 do or I/O iteration error 

43 do end missing 

50 illegal statement in block data 

51 multiply defined labels 

52 undefined label 

53 dimension mismatch 

54 expression syntax error 

55 end of statement in hollerith constant 

56 array too large 

99 3 table overflow 

101 unrecognized statement 

Runtime diagnostics: 

1 invalid log argument 

2 bad arg count to amod 

3 bad arg count to atan2 

4 excessive argument to cabs 

5 exp too large in cexp 

6 bad arg count to cmplx 

7 bad arg count to dim 

8 excessive argument to exp 

9 bad arg count to idim 

10 bad arg count to isign 

11 b ad arg count to mod 

12 bad arg count to sign 

13 illegal argument to sqrt 

14 assigned/computed goto out of range 

15 subscript out of range 

100 illegal I/O unit number 

101 inconsistent use of I/O unit 

102 cannot create output file 

103 cannot open input file 

104 EOF on input file 

105 illegal character in format 

106 format does not begin with ( 

107 no conversion in format but non-empty 
list 

108 excessive parenthesis depth in format 

109 illegal format specification 

110 illegal character in input field 

111 end of format in hollerith specification 
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999 unimplemented input conversion 

BUGS The following is a list of those features not yet 

impl ement ed : 

loading of common (a BLOCK DATA program must be 
written to allocate common). 

arithmetic statement functions 

data statements 

backspace, endfile, rewind runtime 

binary I/O 

no scale factors on input 

OWNER dmr, ken 
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NAME fed — edit associative memory for form letter 

SYNOPSIS fed 

DESCRIPTION fed is used to edit a form letter associative 

memory file, form.m, which consists of named 
strings. Commands consist of single letters fol- 
lowed by a list of string names separated by a 
single space and ending with a new line. The 
conventions of the Shell with respect to '*' and 
'?' hold for all commands but e and m where 
literal string names are expected. The commands 
are: 



e name. 



edit writes the string whose name is name, 
onto a temporary file and executes the sys- 
tem editor ed. On exit from the system edi- 
tor the temporary file is copied back into 
the associative memory. Each argument is 
operated on separately. The sequence of 
commands to add the string from 'file* to 
memory with name 'newname* is as follows: 

e newname 

(printed by ed) 

r file 

w 

q (get out of ed) 

q (get out of fe) 

To dump a string onto a file: 

e name 

200 (printed by ed) 

w filename 

q (get out of ed) 

q (get out of fe) 



d [ name 1 ... ] 

deletes a string and its name from the 
memory. When called with no arguments d 
operates in a verbose mode typing each 
string name and deleting only if a 'y' is 
typed. A 'q' response returns to command 
level. Any other response does nothing. 



m name,, name,. ... 
1 2 

(move) changes the name of name,, to name- 
and removes previous string name^ if one 
exists. Several pairs of arguments may be 
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given. 



n [ name 1 ... ] 

(names) lists the string names in the 
memory. If called with the optional argu- 
ments, it just lists those requested. 



p name 1 . . . 

prints the contents of the strings with 
names given by the arguments. 



q (cjuit) returns to the system. 



Ctfi][f] 

checks the associative memory file for con- 
sistency. The optional arguments do the 
following: 

p causes any unaccounted for string to be 
printed 

f fixes broken memories by adding 

unaccounted-for headers to free storage 
and removing references to released 
headers from associative memory. 



FILES 

SEE ALSO 
DIAGNOSTICS 



/tmp/ftmo? temoorary 
form.m associative memory 

form(l) f ed(l), sh(l) 

'?' unknown command 

'Cannot open temp, file' — cannot create a tem- 
porary file for ed command 

'name not in memory.' if string 'name' is not in 
the associative memory and is used as an argument 
for d or m. 



BUGS 
OWNER 



rhm, lie 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUSS 

OWNER 



find — find file with given name 

find name or number ... 

find searches the entire file system hierarchy 
and gives the path names of all files with the 
specified names or (decimal) i-numbers. 

z 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



form — form letter generator 



form proto arg 



form generates a form 'letter from a prototype 
letter, an associative memory, arguments and in a 
special case, the current date, 

*f form is invoked with the proto argument 'x', 
the associative memory is searched for an entry 
with name 'x' and the contents filed under that 
name are used as the prototype. If the search 
fails, the message w [x]:"* is typed on the console 
and whatever text is typed in from the console,, 
terminated by two new lines, is used as the pro- 
totype. 

If the prototype argument is missing, '{Setter}' 
is assumed. 

Basically, form is a copy process from the proto- 
type to the outout file. If an element of the 
form [n] (where n is a digit from 1 to 9) is 
encountered, the nth argument arg is inserted in 
its place, and that argument is then rescanned. v - 
If [0] is encountered, the current date is in- 
serted. If the desired argument has not been 
given, a message of the form " [n] •" is typed. 
The response typed in then is used for that argu- 
ment. 

If an element of the form [name] or {name} is 
encountered, the name is looked up in the associ- 
ative memory. If it is found, the contents of 
the memory under this narHe^replaces the original 
element (again rescanned).. If the name is not 
found, a message of the form "[name] :" is typed. 
The response typed in is used for that element. 
The response is entered in the memory under the 
name if the name is enclosed in [] . The response 
is not entered in the memory but is remembered 
for the duration of the letter if the name is 
enclosed in {}. 

In both of the above cases, the response is typed 
in by entering arbitrary text terminated by two 
new lines. Only the first of the two new lines 
is passed with the text. 

If one of the special characters [{] }\ is preced- 
ed by a \, it loses its special character. 

If a filE named "forma" already exists in the 
users directory, "formb" is used as the output 
file and so forth to "formz". 
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FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 

OWNER 



The file form.m" is created if none exists. 
Because form.m is operated on by the disc allo- 
cater, it should only be changed by using fed , 
the form letter editor, or form . 

form.m associative memory 
form? outDUt file (read only) 

fed(l), type(l), roff(l) 

"cannot open output file" "cannot open memory 
file" when the appropriate files cannot be locat- 
ed or created. 

An unbalanced ] or } acts as an end of file but 
may add a few strange entries to the associative 
memory. 

rhm,llc 
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NAME goto — command transfer 

SYNOPSIS goto label 

DESCRIPTION goto is only allowed when the Shell is taking 

commands from a file. The file is searched f (from 
the beginning) for a line beginning with ":" fol- 
lowed by one or more spaces followed by the 
label . If such a line is found, the goto command 
returns, since the read pointer in the command 
file points to the line after the label, the 
effect is to cause the Shell to transfer to the 
labelled line. 

":" is a do-nothing command that only serves to 
place a label. 

FILES 

SEE ALSO sh(l), :( I) 

DIAGNOSTICS l!^ oto error"*, if^the input file is a typewriter; 

"label not found". 

BUGS 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



if — conditional command 

if expr command [ arg, ... ] 

if evaluates the expression expr . and if its 
value is true , executes the given command with 
the given arguments. 

The following primitives are used to construct 
the expr ; 

-r file 

true if the file exists and is readable. 

dZ f ile 

true if the file exists and is writable 

-c file 

true if the file either exists and is 
writable, or does not exist and is 
cr eat able. 

s1 = s2 

true if the strings s;1_ and £2. are equal. 

s1 1= s2 

true if the strings sj[ and .§2. are not 
equal . 

These primaries may be combined with the follow- 
ing operators: 



! 



-a 



unary negation operator 



binary and operator 



binary or operator 

X expr J 

parentheses for grouping. 

-a has higher precedence than -= o. Notice that 
all the operators and flags are separate argu- 
ments to JLf and hence must be surrounded by 
spaces. 



FILES 

SEE ALSO 

DIAGNOSTICS 



sh(l) 

"if error", if the expression has the wrong 
syntax; "command not found.' 



- 1 
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BUGS "-C* always indicates the file is cr eat able, even 

if it isn't. 

OWNER dmr 
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1ST AT (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



istat — get inode status 



istat inumber 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



istat gives information about one or more i-nodes 
on the file system /dev/rkO . 

The information is basically in the same for as 
that for stat(l). All information is self- 
explanatory except the mode. The mode is a 
seven-character string whose characters mean the 
following: 

1 a: i-node is allocated 

u: i-node is free (no file) 

2 s: file is small (smaller than 4096 bytes) 
1: file is large 

3 d: file is a directory 
x: file is executable 

u: set user ID on execution 
-: none of the above 

4 r: owner can read 

-: owner cannot read 

5 w: owner can write 

-: owner cannot write 

6 r: non -owner can read 

-: non-owner cannot read 

7 w: non-owner can write 

-: non-owner cannot write 

The owner is almost always given in symbolic 
form; however if he cannot be found in 
w /etc/uids M a number is given. 

If the number of arguments to stat is not exactly 
1 a header is generated identifying the fields of 
the status information. 

/etc/uids, /dev/rkO 

stat(l) ls(i) (-1 option) 

"name?" for any error. 

istat should take an optional alternate filesys- 
tem argument. 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



Id — link editor 



Id [ -usaol ] name 



Id combines several object programs into one; 
resolves external references; and searches li- 
braries. In the simplest case the names of 
several object programs are given, and Id com- 
bines them, producing an object module which can 
be either executed or become the input for a 
further Jxi run. In the latter case, the "-r" 
option must be given to preserve the relocation 
bits. 

The argument routines are concatenated in the 
order specified. The entry point of the output 
is the beginning of the first routine. 

If any argument is a library, it is searched 
exactly once. Only those routines defining an 
unresolved external reference are loaded. If a 
routine from a library references another routine 
in the library, the referenced routine must ap- 
pear after the referencing routine in the li- 
brary. Thus the order of libraries is important. 

Id understands several^flag arguments which are 
written preceded by a M - M : 

-s "squash" the output, that is, remove the 
symbol table and relocation bits to save 
space (but impair the usefulness of the 
debugger). This information can also be 
removed by strip . 

-u take the following argument as a symbol and 
enter it as undefined in the symbol table. 
This is useful for loading wholly from a 
library, since initially the symbol table 
is empty and an unresolved reference is 
needed to force the loading of the first 
rout in e . 

-1 This option is an abbreviation for a li- 
brary name, "-l" alone stands for 
Vusr/lib/liba.a", which is the standard 
system library for assembly language pro- M 
grams, "-lx" stands for /usr/lib/libx.a" 
where x is any char act er. M There are^li- 
braries for Fortran (x= w f H j. C (x^c"), 
Explor (x="e H ) and B (x= w b ). 

-x Do not preserve local (non-.globl) symbols 
in the output symbol table; only enter 
external symbols. This option saves some 
space in the output file. 

- 1 - 
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FILES 

SEE ALSO 
DIAGNOSTICS 



BUGS 



OWNER 



-r generate relocation bits in the output file 
so that it can be the subject of another Id 
run. 

The output of Id is left on a. out . This file is 
executable only if no errors occurred during the 
load. 

/usr /lib/lib?. a libraries 
a. out output file 

as(l), ar(l) 

"file not found" — bad argument 

"bad format" — bad argument 

"relocation error" — bad argument (relocation 
bits corrupted) 

"multiply defined" — same symbol defined twice in 
same load 

"un" — stands for "undefined symbol" 

"symbol not found" — loader bug 

"can't move output file" — can't move temporary 
to a. out file 

"no relocation bits" — and input file lacks relo- 
cation information 

"too many symbols" — too many references to 
external symbols in a given routine 

"premature EOF" 

"can't create l.out" — cannot make temporary file 

"multiple entry point" — more than one entry 
point specified (not possible yet). 

Instructions in the data segment are not relocat- 
ed properly. 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



In — make a link 

In name.. [ name- ] 

In creates a link to an existing file 'name. . If 
name- is given, the link has that name; otherwise 
it is placed in the current directory and its 
name is the last component of name,j . 

It is forbidden to link to a directory or to link 
across file systems. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OWNER 



rm(I) 



There is nothing particularly wrong with .In, but 
links don't work right with respect to the backup 
system: one copy is backed up for each link, and 
(more serious) in case of a file system reload 
both copies are restored and the information that 
a link was involved is lost, 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 



login — sign onto UNIX 

locrin [ username [ password ] ] 

The locrin command is used when a user initially 
signs onto UNIX, or it may be used at any time to 
change from one user to another. The latter case 
is the one summarized above and described here. 
See login (VII) for how to dial up initially. 

If locrin is invoked without an argument, it will 
ask for a user name, and, if appropriate, a pass- 
word. Echoing is turned off (if possible) during 
the typing of the password, so it will not appear 
on the written record of the session. 

After a successful login, accounting files are 
updated and the user is informed of the existence 
of mailbox and message-of-the-day files. 

Login is recognized by the Shell and executed 
directly (without forking). 



/tmp/utrop 
/tmp/wtmp 
mailbox 
/etc/motd 



account ing 

accounting 

mail 

message-of-the-day 



login(VIl), init(VIl), getty(VIl), mail(l) 

"login^ incorrect^, if the name or the password M is 
bad. "No Shell,", "cannot open password file,*' 
"no directory: " consult a UNIX programming coun- 
cilor. 



BUGS 
OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



Is — list contents of directory- 
Is [ -ltasd ] name^ ... 

Is lists the contents of one or more directories 
under control of several options: 

1 list in 2 on 9 format, giving i -number, mode, 
owner, size in bytes, and time of last 
modification for each file, (see stat for 
format of the mode) 

t sort by time modified (latest first) instead 
of by name, as is normal 

a list all entries; usually those beginning 
with "." are suppressed 

s give size in blocks for each en^ry 

d if argument is a directory, list only its 
name, not its contents (mostly used with 
"-l" to get status on directory) 

If no argument is given, " ." is listed. If an 
argument is not a directory, its name is given. 

/etc/uids to get user ID's for Is -*& 

stat( I) 



ft !• 



name nonexistent ; name unreadable ; name 
unstatabl e." 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



mail — send mail to another user 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



mail [ letter person 



] 



mail without an argument searches for a file 
called mailbox , prints it if present, and asks if 
it should be saved. If the answer is "y"» the 
mail is renamed mbox, otherwise it is deleted. 
The answer to the above question may be supplied 
in the letter argument . 

When followed by the names of a letter and one or 
more people, the letter is appended to each 
person's mailbox . Each letter is preceded by the 
sender's name and a postmark. 

A person is either the name of an entry in the 
directory /usr . in which case the mail is sent to 
/usr/per son/mailbox , or the path name of a direc- 
tory, in which case mailbox in that directory is 
used. 

When a user logs in he is informed of the pres- 
ence of mail. 



/etc/uids 

mailbox 

mbox 

login(l) 



to map uids 
input mail 
saved mail 



Who are you? if the user n cannot be identif ed t 
for some reason (a bug), "cannot send to user' 
if mailbox cannot be opened. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



man — run off section of UNIX manual 

man title [ section ] 

man is a shell command file that will locate and 
run off a particular section of this manual. 
Title is the the desired part of the manual. 
Section is the section number of the manual. (In 
Arabic, not Roman numerals.) If section is miss- 
ing, _1 is assumed. For example, 

man man 

would reproduce this page. 

/sys /man/man?/* 

sh(l), roff(l) 

"File not found", "Usage 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



mesg — permit or deny messages 

mesg [ n ] [ y ] 

mesg n forbids messages via write by revoking 
non-user write permission on the user's typewrit- 
er, mesg y reinstates permission, mesg with no 
argument reverses the current permission. In all 
cases the previous state is reported. 



FILES 


/dev/tty? 


SEE ALSO 


write(l) 


DIAGNOSTICS 


"? w if th 




er 


BUGS 


— 


OWNER 


dmr. ken 



if the standard input file is not a typewrit- 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



mkdir — make a directory 

mkdir dirname ... 

mkdir creates specified directories in mode 17. 

The standard entries "." and M .. M are made au- 
tomatically. 

rmdir(l) 
"dirname ?" 

ken, drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



OWNER 



mount — mount file system 

/etc/mount special dir 

mount announces to the system that a removable 
file system has been mounted on the device 
corresponding to special file special . Directory 
dir (which must exist already) becomes the name 
of the root of the newly mounted file system. 



umount ( I ) 

"?", if the special file is already in use, can- 
not be read, or if dir does not exist. 

Should be usable only by the super -user. 

It is possilbe to mount the same file system pack 
twice. This is a very efficient way to destroy a 
pack. 

ken, dmr 
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NAME mt — manipulate magtape 

SYNOPSIS mt [ key ] [ name . .. ] 

DESCRIPTION mt saves and restores selected portions of the 

file system hierarchy on magtape. Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func- 
tion letter and possibly one or more function 
modifiers, other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters: 

r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. The old contents of the 
tape are lost. 

x extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted. 

t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled. 

1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 

The following characters may be used in addition 
to the letter which selects the function desired. 

0, . .., 7 This modifier selects the drive on 
which the tape is mounted, "o" is the 
default. 

v Normally mt does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 
to indicate what is happening. 

a file is being added 

x file is being extracted 

The v option can be used with r and x only. 

f causes new entries copied on tape to be 

- 1 - 



6/12/72 MT (I) 

'fake' in that only the entries, not the 
data associated with the entries are updat- 
ed. Such fake entries cannot be extracted. 
Usable only with r. 

w causes mt to pause before treating each 
file, type the indicative letter and the 
file name (as with vj and await the user's 
response. Response y" means "yes", so the 
file is treated. Null response means "no", 
and the file does not take gart in whatever 
is being done. Response "x means "exit"; 
the mt command terminates immediately. In 
the x function, files previously asked 
about have been extracted already. With r, 
no change has been made to the tape. 

m make (create) directories during an x if 
necessary. 

i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes. 

FILES /dev/mt? 

SEE ALSO tap(l), tap(V) 

DIAGNOSTICS Tape open error 

Tape read error 
Tape write error 
Directory checksum 
Directory overflow 
Tape overflow 

Phase error (a file has changed after it was 
selected for dumping but before it was dumped) 

BUGS The m option does not work correctly. The i 

option is not yet implemented. 

OWNER ken 
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NAME mv — move or rename a file 

SYNOPSIS mv name^ name 2 

DESCRIPTION mv changes the name of name., by linking to it 

under the name name- and then unlinking name,. . 
If the new name is a directory, the file is moved 
to that directory under its old name. Direc- 
tories may only be moved within the same parent 
directory (just renamed). 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS Since my is implemented by combinations of link 

and unlink , it cannot be used to move between 
file systems. 

OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



m6 — general purpose macro processor 

m6 [ ^d argl ] [ arg2 [ arg3 ] ] 

m6 takes input from file arg2 (or standard input 
if arg2 is missing) and places output on file 
arg3 (or standard output), A working file of 
definitions, "m.def" , is initialized from file 
argl if that is supplied. M6 differs from the 
standard [1] in these respects: 

#trace:, #source: and #end: are not defined. 

#meta,arg1 ,arg2 : transfers the role of metachar- 
acter argl to character arg2. If two metacharac- 
ters become identical thereby, the outcome of 
further processing is not guaranteed. For exam- 
ple, to make []{} play the roles of #:<> type 

\#meta,<\#>,[: 
[meta,<:>,] : 

[meta, [substr,«»,1 , 1 ;, {] 
[meta, [substr, {{», 2,1 ;, }] 

#del,arg1: deletes the definition of macro argl . 

#save: and #rest: save and restore the definition 
table together with the current metacharacters on 
file m.def. 

#def ,arg1 ,arg2,arg3: works as in the standard 
with the extension that an integer may be sup- 
plied to arg3 to cause the new macro to perform 
the action of a specified builtin before its 
replacement text is evaluated. Thus all bultins 
except #def: can be retrieved even after dele- 
tion. Codes for arg3 are: 

- no function 

1,2,3,4,5,6 - gt,eq,ge,lt,ne,le 

7,8 - seq,sne 

9,10,11,12,13 - add, sub,mpy,div, exp 

20 - if 

21 ,22 - def ,copy 

23 - meta 

24 - size 

25 - substr 
26,27 - go,gobk 

28 - del 

29 - dnl 

30,31 - save, rest 

m.def — working file of definitions 
/sys/lang/mdir/m6a — m6 processor proper (/bin/m6 
is only an initializer) 
/sys/lang/mdir/m6b — default initialization for 
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m.def 

SEE ALSO [1] M6 reference 

DIAGNOSTICS "err" — a bug, an unknown built in or a bad de- 
finition table 

" t oord" — can't ooen input or initial definitions 
"opwr" — can't open output "ovc" — overflow of 
nested calls 

"ova" — overflow of nested arguments 
^ovd" — overflow of definitions 
"rdd" — can't read definition table 
"wrd" — can't write definition table, either on 
#save: or on garbage collection 

BUGS Characters in internal tables are stored one per 

word. They really should be packed to improve 
capacity. For want of space (and because of 
unpacked formats) no file arguments have been 
provided to #save: or #rest: Again to save space, 
garbage collection makes calls on #save: and 
#rest: and so overwrites m.def. 

OWNER doug 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



nm — print name list 

nm [ name ] 

nm prints the symbol table from the output file 
of an assembler or loader run. Each symbol name 
is preceded by its value £ blanks if undefined) 
and one of the letters "u (undefined) "a" (abso- 
lute) W T** (text segment symbol), "d" (data seg- 
ment symbol), or "b" (bss segment symbol). Glo- 
bal symbols have their first character under- 
lined. The output is sorted alphabetically. 

If no file is given, the symbols in a. out are 
listed. 

a. out 

as(l), ld(l) 

M 9 M 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



nroff — format text 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



nroff [ +number1 ] [ -number 2 ] [ -stop ] name.. 
nroff formats text according to control lines 



embedded in the text in files name 



1» 



in a 



manner similar to roff(l). nroff permits wider 
page layout flexibility that roff ; examples in- 
clude arbitrary format and length for page head- 
ings and footings, page shaping, some footnote 
capability, and double column output (with the 
aid of a postprocessor, ov(l) ). Encountering a 
nonexistent f ile^terminates printing. The op- 
tional argument "^numberl" causes printing to 
begin at the first page numbered numberl; the 
optional argument "-number 2" stops printing after 
the page numbered number2. The optional argument 
"-stop or "-s" causes printing to stop before 
each page including the first to allow paper 
manipulation; printing is resumed upon receipt of 
an interrupt signal. An interrupt signal re- 
ceived during printing terminates all printing. 
Incoming inter con sole messages are turned off 
during printing, and the original message accep- 
tance state is restored upon termination. 

nroff is described in a separate publication [1]. 



/etc/suftab 
rtm? 



suffix hyphenation tables 
temporary 



[1] (See J. F. Ossanna) 



none 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



od — octal dump 

od name [ origin ] 

od dumps a file in octal, eight words per line 
with the origin of the line on the left. If an 
octal origin is given it is truncated to mod 16 
and dumping starts from there, otherwise from 0. 
Printing continues until an end-of-file condition 
or until halted by sending an interrupt signal. 

Since od does not seek, but reads to the desired 
starting point, od (rather than db) should be 
used to dump special files. 



FILES 


— — 


SEE ALSO 


db(l) 


DIAGNOSTICS 


it _. t» 

9 


BUGS 





OWNER 


ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



opr — off line print 

opr file,, . , . 

opr will arrange to have the 201 data phone dae- 
mon submit a job to the Honeywell 6070 to print 
the file arguments. Normally, each file is 
printed in the state it is found when the data 
phone daemon reads it. If a particular file 
argument is preceded by + then opr will make a 
copy for the daemon to print. If the file argu- 
ment is preceded by - then opr will unlink the 
file. 



/usr/dpd/* 
/etc/ident 
/etc/dpd 

dpd(l), ident(V) 



spool area 

personal ident cards 

daemon 



OWNER 



Since all but the + option in opr is implemented 
with links , one cannot use these options for 
files not in /usr . 

opr should recognize + and - alone and apply them 
to all subsequent arguments. 

ken 
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NAME ov — overlay pages 

SYNOPSIS ov filename 

DESCRIPTION ov is a postprocessor for producing double column 

formatted text when using nroff(l). ov assumes 
that the named file contains an even number of 66 
line pages and literally overlays successive 
pairs of pages. 

FILES none 

SEE ALSO nroff (I) 

DIAGNOSTICS none 

BUGS Other page lengths should be permitted. 

OWNER jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



pr — print file 

pr [ -lcm ] name,j ... 

pr produces a printed listing of one or more 
files. The output is separated into pages headed 
by the name of the file, a date, and the page 
number. 

The optional flag ^1 causes each page to contain 
78 lines instead of the standard 66 to accommo- 
date legal size paper. 

The optional flags j^ (current date) and -m 
(modified date) specify which date will head all 
subsequent files, ^m is default. 

Interconsole messages via write(l) are forbidden 
during a pr. 

/dev/tty? to suspend messages. 

cat(l), cp(l), mesg(l) 

— (files not found are ignored) 

none 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



rew — rewind tape 

rew [ digit ] 

rew rewinds DECtape drives. The digit is the 
logical tape number, and should range from to 
7. A missing digit indicates drive 0. 

/dev/tap? 



? if there is no tape mounted on the indicated 
drive or if the file cannot be opened. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



rm — remove (unlink) files 

rm name,. • • • 

rm removes the entries for one or more files from 
a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a 
file requires write permission in its directory, 
but neither read nor write permission on the file 
itself. 

Directories cannot be removed by rm; cf . rmdir . 

none 

rmdir(l) 

If the file cannot be removed or does not exist, 
the name of the file followed by a question mark 
is typed. 

rm probably should ask whether a read-only file 
is really to be removed. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



rmdir — remove directory 

rrodir dir<j . . . 

rmdir removes (deletes) directories. The direc- 
tory must be emptv (except for the standard en- 
tries M . w and " . . , which rmdir itself removes). 
Write permission is required in the directory in 
which the directory appears. 

none 



"dir?" is printed if directory dir cannot be 
found, is not a directory, or is not removable. 

"dir — directory not empty" is printed if dir 
has entries other than w . w or "..". 



BUGS 
OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



roff — format text 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



roff [ +number1 ] [ -number2 ] [ -stop ] name,. 



roff formats text according to control lines 
embedded in the text in files name 1 f ... . 
Encountering a nonexistent file terminates print- 
ing. The optional argument %number1 ,, causes 
printing to begin at the first gage numbered 
number 1; the optional argument -number2" stops 
printing after the^page numb ered ft number 2 . The 
optional argument " -stop " or "-s" causes printing 
to stop before each page including the first to 
allow paper manipulation; printing is resumed 
upon receipt of an interrupt signal. An inter- 
rupt signal received during printing terminates 
all printing. Incoming inter con sole messages are 
turned off during printing, and the original mes- 
sage acceptance state is restored upon termina- 
tion. 

roff is described in a separate publication [1]. 



/etc/suftab 
/tmp/rtm? 



suffix hyphenation tables 
temporary 



[1] (See J. F. ossanna) 



none 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



salv — file system salvage 

/etc/salv 

salv will reconstruct the file system /dev/rkO to 
a consistent state. This is the first step in 
putting things together after a bad crash. Salv 
performs the following functions: 

A valid free list is constructed. 

All bad pointers in the file system are 
zeroed. 

All duplicate pointers to the same block are 
resolved by changing one of the pointers to 
point at a new block containing a copy of the 
data. 

After a salv, a warm boot must be performed in- 
stantly to effect the change made. (Because the 
salv works on the disk copy of the file system 
super-block, and the core copy is unaffected.) 

After a salv, files may be safely created and 
removed without causing more trouble. However, 
it is more likely than not that directories are 
corrupted as well, so a ds should be performed. 

/d ev/rkO 

check (I), ds(l) 



The file system to be salvaged should be an argu- 
ment. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



sh — shell (command interpreter) 



sh [ name [ arg. 



[ arg 9 ] ] ] 



sh is the standard command interpreter. It is 
the program which reads and arranges the execu- 
tion of the command lines typed by most users. 
It may itself be called as a command to interpret 
files of commands. Before discussing the argu- 
ments to the shell used as a command, the struc- 
ture of command lines themselves will be given. 

Command lines 

Command lines are sequences of commands separated 
by command delimiters. Each command is a se- 
quence of non-blank command arguments separated 
by blanks. The first argument specifies the name 
of a command to be executed. Except for certain 
types of special arguments discussed below, the 
arguments other than the command name are simply 
passed to the invoked command. 

If the first argument is the name of an execut- 
able file, it is invoked; otherwise the string 
w /bin/ w is prepended to the argument. (In this 
way the standard commands, which reside in 
"/bin" , are found.) If the "/bin*" file exists, 
but is not executable, it is used by the shell as 
a command file. That is to say it is executed as 
input as though it were typed from the console. 
If all attempts fail, a diagnostic is printed. 

The remaining non-special arguments are simply 
passed to the command without further interpreta- 
tion by the shell. 

Command delimiters 

There are three M command delimiters: w the new- 
line, **;", and M & w . The semicolon " } n specifies 
sequential execution of the commands so 
separated; that is, 

coma; comb 

causes the execution f irst^of command coma , then 
of comb . The ampersand "&" causes simultaneous 
execution: 

coma & comb 

causes coma to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 
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coma & 

causes coma to be executed and the shell immedi- 
ately to request another command without waiting 
for coma . 

Termination Reporting 

If a command (not followed by "&" ) terminates 
abnormally, a message is printed. (All termina- 
tions other than exit and interrupt are con- 
sidered abnormal. ) The following is a list of the 
abnormal termination messages: 

Bus error 

Trace trap 

Illegal instruction 

IOT trap 

Power fail trap 

EMT trap 

Bad system call 

Quit 

Error 

If a core image is produced, H — Core dumped" is 
appended to the appropriate message. 

Redirection of l/o 

Three character sequences cause the immediately 
following string to be interpreted as a special 
argument to the shell itself, not passed to the 
command . . 

An argument of the form "<arg w causes the file 
arcr to be used as the standard input file of the 
given command. 

An argument of the form ">arg" causes file "arg" 
to be used as the standard output file for the 
given command. "Arg'* is created if it did not 
exist, and in any case is truncated at the 
outset. 

An argument of the form w >>arg" causes file "arg" 
to be used as M the M standard output for the given 
command. If "arg" did not exist, it is created; 
if it did exist, the command output is appended 
to the file. 

Generation of argument lists 

If tf anv argument contains any of the characters 
M ? M , *" or '[', it is treated specially as fol- 
lows. The current directory is searched for 
files which match the given argument. 
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The character "*" in an argument matches any 
string of characters in a file name (including 
the null string). 

The character "?" matches any single character in 
a file name. 

Each w [ w must be paired with a matching " ] w . The 
characters between " [" and "]" specify a class of 
characters. It matches any single character in a 
file name which is in the class. An ordinary 
character in the brackets specifies that charac- 
ter to be in the class. A pair of characters 
separated by " -" specifies each character lexi- 
cally greater than or equal to the first and less 
than or equal to the second member of the pair is 
to be included in the class. If the first member 
of the pair lexically exceeds the second, the 
second member is the sole character specified. 

Other characters match only the same character in 
the file name. 

For example, "*" matches all file names; "?*' 
matches all one-character file names; " t [ab]*.s w w 
matches all f ile^names^beginning with "a" or "b" 
and ending with w .s"; "?[zi-m] M matches all two- 
character file names ending with "z" or the 
letters "i" through V. 

If w the argument with "**" or ,, ? w also contains a 
V, a slightly different procedure is used: 
instead of the current directory, the directory 
used is the one o obtained by taking the argument 
up to the last " /" before a "*" or "?". The 
matching process matches the remainder of the 
argument after this " /" against the files in the 
derived directory. For example^ "/usr/dmr/a* .s" 
matches all files in directory "/usr/dmr" which 
begin with "a" and end with ".s". 



In any event, a list of names is obtained which 
match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
argument s^repl aces the single argument containing 
the w * w f "[", or "? w . The same process is car- 
ried out for each argument (the resulting lists 
are not merged) and finally the command is called 
with the resulting list of arguments. 

For example: directory /usr/dmr contains the 
files al.s, a2.s, ..., a9.s. From any directory, 
the command 

as /usr/dmr/a? .s 
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calls as with arguments /usr/dmr/a1 .s , 
/usr/dmr/a2.s, . .. /usr/dmr/a9.s in that order. 

Quoting 

The character W \ M causes the immediately follow- 
ing character to lose any special meaning it may 
have to the shell; in this way M < w , ">* , t and 
other characters meaningful to the shell may be 
passed as part of arguments. A special case of 
this feature allows the continuation of commands 
onto more than one line: a new-line preceded by 
"V is translated into a blank. 

Sequences of characters enclosed in double (") or 
single ( ' ) quotes are also taken literally. 

Argument passing 

When the shell is invoked as a command, it has 
additional string processing capabilities. Re- 
call that the form in which the shell is invoked 
is 

sh [ name [ arg.j ... [ arg g ] ] ] 

The name is the name of a file which will be read 
and interpreted. If not given, this subinstance 
of the shell will continue to read the standard 
input file. 

In the file, character sequences of the form 

M $n" , f where n is a digit 0, ..., 9, are replaced 

by the nth argument to the invocation of the 

shell (arg ). "so" is replaced by name , 
n 

End of file 

An end-of-file in the shell's input causes it to 
exit. A side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file. 

Special command s 

Two commands are treated specially by the shell. 

"chdir" is done without spawning a new process by 
executing the sys chdir primitive. 

"Login" is done by executing /bin/login without 
creating a new process. 

These peculiarities are inexorably imposed upon 
the shell by the basic structure of the UNIX pro- 
cess control system. It is a rewarding exercise 
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FILES 
SEE ALSO 

DIAGNOSTICS 



BUGS 



OWNER 



to work out why. 

Command file errors 

Any shell-detected error in a file of commands 
causes that shell to cease executing that file. 

/etc/glob, which interprets "*", *"?", and " [" . 

"The UNIX Time-sharing System", which gives the 
theory of operation of the shell. 

"input not found", when a command file is speci- 
fied which w cannot be read; 

"Arg count**, if the number of arguments to the 
chdir pseudo-command is not exactly 1 , or if "*", 
H?**, or ** [** is §f used inappropriately; 
**Bad directory", if the directory given in 
"chdir" cannot be switched to; 

"Try again", if no new process can be created to 
execute the specified command; 
""' imbalance , if single or double quotes are 
not matched £ 

"input file , if an argument after "<" cannot be 
read; 

"output file", if an argument after ">" or ">>" 
cannot be written (or created); 

"No command", if the specified command cannot be 
executed. 

"no match", if no arguments are generated for a 
command which contains ***", "?", or "[". 
Termination messages described above. 

If^any argument contains a quoted "*" , "?", or 
" [", then all instances of these characters must 
be quoted. This is because sh calls the glob 
routine whenever an unquotedf" ,r *". "?", or [ is 
noticed; the fact that other instances of these 
characters occurred quoted is not noticed by 
glob . 

drar, ken 
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NAME sort — sort a file 

SYNOPSIS sort input output 

DESCRIPTION sort will sort the input file and write the sort- 

ed file on the output file. The sort is line- 
by-line in increasing ASCII collating sequence. 

Space required is 6 * numb er-of -lines in bytes. 

FILES /tmp/stra? 

SEE ALSO 

DIAGNOSTICS 

BUGS Sort does not put a maximum on the size of file 

that it sorts. Thus a bus error will occur if 
too large an input file is supplied. 

The input is copied to a temporary file. Thus 
the maximum file that can be sorted is the max- 
imum non-special file (currently 64K bytes.) 

OWNER dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
OWNER 



stat — get file status 

stat name. . . . 
_ i 

stat gives several kinds of information about one 
or more files: 

i-number 

access mode 

number of links 

owner 

size in bytes 

date and time of last modification 

name (useful when several files are. named) 

All information is self-explanatory except the 
mode. The mode is a six-character string whose 
characters mean the following: 

1 s: file is small (smaller than 4096 bytes) 
1: file is large 

2 d: file is ' a directory 
x: file is executable 

u: set user ID on execution 
-: none of the above 

3 r: owner can read 

-: owner cannot read 

4 w: owner can write 

-: owner cannot write 

5 r: non-owner can read 

-: non-owner cannot read 

6 w: non-owner can write 

-: non-owner cannot write 

The owner is almost always given in symbolic 
form; however if he cannot be found in 
"/etc/uids" a number is given. 

If the number of arguments to stat is not exactly 
1 a header is generated identifying the fields of 
the status information. 

/etc/uids 

istat(l), ls(l) (-1 option) 

"name?" for any error. 

dmr 



- 1 - 



3/15/72 



STRIP (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



strip — remove symbols and relocation bits 

strip name,. ... 

strip removes the symbol table and relocation 
bits ordinarily attached to the output of the 
assembler and loader. This is useful to save 
space after a program has been debugged. 

The effect of strip is the same as use of the -s 
option of Id. 



/tmp/stm? 
ld(l), as(l) 



temporary file 



Diagnostics are given for: non-existent argument; 
inability to create temporary file; 
improper format (not an object file); 
inability to re-read temporary file. 



BUGS 
OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUSS 

OWNER 



stty — set teletype options 

stty option. ... 

Stty will set certain I/O options on the current 
output teletype. The option strings are selected 
from the following set: 



allow even parity, 
disallow even parity, 
allow odd parity 
disallow odd parity 
raw input (no erase/kill) 

negate raw mode (erase/kill) 

allow (and echo) cr for If. 

negate cr mode. 

echo back every character typed. 

do not echo characters as typed. 

map upper case to lower case 

do not map case 

map tabs f into spaces 

do not map tabs 



even 

-even 

odd 

-odd 

raw 

-canon 

-raw 

canon 

cr 

-nl 

-cr 

echo 

full 

-half 

half 

-echo 

-full 

lease 

-ucase 

ucase 

-lease 

space 

-tab 

tab 

-space 

delay calculate cr and tab delays. 

-delay no cr/tab delays 

ebedic ebedic ball conversion (2741 only) 

-corr es 

corr es correspondence ball conversion (2741 only) 

-ebedic 

standard output. 

stty(Il) 

"Bad opt ion s" 

jfo 



- 1 



3/15/72 



SU (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



su — become privileged user 

su password 

su allows one to become the super -user, who has 
all sorts of marvelous powers. In order for su 
to do its magic, the user must pass as an argu- 
ment a password. If the password is correct, su 
will execute the shell with the UID set to that 
of the super -user. To restore normal UID 
privileges, type an end-of-file to the super -user 
shell . 



sh(l) 

"sorry" if password is wrong 

dmr, ken 
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NAME sum — sum file 

SYNOPSIS sum name . . . 

DESCRIPTION sum sums the contents of one or more files. A 

separate sum is printed for each file specified, 
along with the number of whole or partial 512- 
word blocks read. 

In practice, sum is often used to verify that all 
of a special file can be read without error. 

FILES none 

SEE ALSO 

DIAGNOSTICS "oprd" if the file cannot opened; " ?" if if an 

error is discovered during the read. 

BUGS none 

0WN1R ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tacct — login accounting by date 

tacct [ wtmp ] 

tacct will produce a printout giving daily con- 
nect time and total number of connects for all 
transactions found in the wtmp file. If no wtmp 
file is given, /tmp/wtm pis used. 

/tmp/wtmp 

init(VIl), acct(l), login(l), wtmp(V) 

"cannot open 'wtmp'" 

acct(l) and tacct(l) should be compined 

dmr , k en 
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NAME tap — manipulate DECtape 

SYNOPSIS tap [ key ] [ name ... ] 

DESCRIPTION tap saves and restores selected portions of the 

file system hierarchy on DECtape. Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func- 
tion letter and possibly one or more function 
modifiers, other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters: 

r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. If files with the same 
names already exist, they are replaced 
(hence the "r"). "same" is determined by 
string comparison, so ",/abc" can never be 
the same as "/usr/dmr/abc" even if 
"/usr/dmr" is the current directory. If no 
file argument is given, " ." is the default. 

u updates the tape, u is the same as r, but 
a file is replaced only if its modification 
date is later than the date stored on the 
tape; that is to say, if it has changed 
since it was dumped, u is the default com- 
mand if none is given. 

d deletes the named files and directories 
from the tape. At least one file argument 
must be given. 

x extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted. 

t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled. 

1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 

The following characters may be used in addition 
to the letter which selects the function desired. 
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0, . .., 7 This modifier selects the drive on 
which the tape is mounted, "o" is the 
def ault . 

v Normally tap does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 
to indicate what is happening. 

r file is being replaced 

a file is being added (not there before) 

x file is being extracted 

d file is being deleted 

The v option can be used with r, u, d, and 
x only. 

c means a fresh dump is being created; the 
tape directory will be zeroed before begin- 
ning. Usable only with r and u. 

f causes new entries copied on tape to be 
'fake' in that only the entries, not the 
data associated with the entries are updat- 
ed. Such fake entries cannot be extracted. 
Usable only with r and u. 

w causes tap to pause before treating each 
file, type the indicative letter and the 
file name (as with vj and await the user's 
response. Response y" means "yes**, so the 
file is treated. Null response means "no", 
and the file does not take gart in whatever 
is being done. Response "x means "exit"; 
fc ^ e tap command terminates immediately. In 
the x function, files previously asked 
about have been extracted already. With 
u, and d no change has been made to the 
tape. 



±.» 



m make (create) directories during an x if 
necessary. 

i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes. 



FILES /dev/tap? 

SEE ALSO mt( I) 

DIAGNOSTICS Tape open error 

Tape read error 
Tape write error 
Directory checksum 
Directory overflow 
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Tape overflow 

Phase error (a file has changed after it was 

selected for dumping but before it was dumped) 

BUGS The m option does not work correctly. The ^i 

option is not yet implemented. 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 



tin — provide time information 

tra [ command arg. • • • • ] 

tm is used to provide timing information. When 
used without an argument, output like the follow- 
ing is given: 



tim 


371:51 


:09 


2:00.8 


ovh 


20:00- 


:33 


17.0 


swp 


13:43 


:20 


4.6 


dsk 


27:14 


:35 


4.5 


idl 


533:08 


:03 


1:33.3 


usr 


24 : 53 : 


:50 


1.2 


der 


0, 


54 


0, 



The first column of numbers gives totals in the 
named categories since the last time the system 
was cold -booted; the second column gives the 
changes since the last time tm was invoked. The 
tim row is total real time ( hours: minutes: 
seconds); unlike the other times, its origin is 
the creation date of tm's temporary file, ovh is 
time spent executing in the system; swp is time 
waiting for swap I/O; dsk is time spent waiting 
for file system disk I/O; idl is idle time; usr 
is user execution time; der is RF disk error 
count (left number) and RK disk error count 
(right number). 

tm can be invoked with arguments which are as- 
sumed to constitute a command to be timed. In 
this case the output is as follows: 



tim 


2.7 


ovh 


0.3 


swp 


0.5 


dsk 


1.8 


idl 


0.0 


usr 


0.0 



The given times represent the number of seconds 
spent in each category during execution of the 
command . 

/tmp/ttmp, /dev/rfO (for absolute times) contains 
the information used to calculate the differen- 
tial times. 

file system(V) 

"? w if the command cannot be executed; ^ can't 
creat temp file" if trouble with ttmp ; "cant read 
super-block" if times cannot be read from system. 

( 1 ) when invoked with a command argument , 
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everything going on at the moment is counted, not 
just the command itself. (2) Two users doing tm 
simultaneously interfere with each other's use of 
the temporary file. 

OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



tss — interface to Honeywell TSS 

tss 

tss will call the Honeywell 6070 on the 201 data 
phone. It will then go into direct access with 
TSS. Output generated by TSS is typed on the 
standard output and input requested by TSS is 
read from the standard input with UNIX typing 
conventions. 

An interrupt signal (ASCII DEL) is transmitted as 
a "break" to TSS. 

Input lines beginning with 2 are interpreted as 
UNIX commands. Input lines beginning with ~ are 
interpreted as commands to the interface routine. 

~<file insert input from named UNIX file 

~>file deliver tss output to named UNIX file 

~p pop the output file 

~q disconnect from tss (quit) 

~r file receive from HIS routine CSR/DACCOPY 

~s file send file to HIS routine CSR/DACCOPY 

Ascii files may be most efficiently transmitted 
using the HIS routine CSR/DACCOPY in this 
fashion. Underlined text comes from TSS. 
AFTname is the 6070 file to be dealt with. 

SYSTEM? CSR/DACCOPY (s) AFTname 
Send Encoded File ~s file 

SYSTEM? CSR/DACCOPY (r) AFTname 
Receive Encoded File ~r file 

/dev/dn0 t /dev/dpO 



DONE when communication is broken. 

When diagnostic problems occur, tss exits rather 
abruptly. 

csr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



tty — get tty name 

tty 

tty gives tt the name of the user's typewriter in 
the form "ttyn" for n a^digit. The actual path 
name is then "/dev/ttyn" . 



not a tty if the standard input file is not a 
typewriter. 



dmr, ken 
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NAME type — type on single sheet paper 

SYNOPSIS type name 1 ... 

DESCRIPTION type copys its input files to the standard out- 

put. After every 6 6 lines, type stops and reads 
the standard input for a new line character be- 
fore continuing. This allows time for insertion 
of single sheet paper. 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



umount — dismount file system 

/etc/umount special 

umount announces to the system that the removable 
file system previously mounted on special file 
special is to be removed. 

Only the super -user may issue this command. 



mount ( I ) 

w _ tt 

? 

This command is not, in fact, restricted to the 
super -user. 

ken , dmr 
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NAME un — undefined symbols 

SYNOPSIS un [name ] 

DESCRIPTION un prints a list of undefined symbols from an 

assembly or loader run. If the file argument is 
not specified, a. out is the default. Names are 
listed alphabetically except that non-global sym- 
bols come first. Undefined global symbols (un- 
resolved external references) have their first 
character underlined. 

FILES a. out 

SEE ALSO as( I), ld(l) 



•t _ •» 



DIAGNOSTICS ? if the file cannot be found. 

BUGS 

OWNER dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



wc — get (English) word count 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



wc name 



wc provides a count of the words, text lines, and 
roff control lines for each argument file. 

A text line is a sequence of characters not be- 
ginning with "." and ended by a new-line fT A roff 
control line is a line beginning with ".' . A 
word is a sequence of characters bounded by the 
beginning of a line, by the end of a line, or by 
a blank or a tab. 



roff (I) 

none; arguments not found are ignored, 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



who — who is on the system 

who [ who-f ile ] 

who , without an argument, lists the name, type- 
writer channel, and login time for each current 
UNIX user. 

Without an argument, who examines the /tmp/utmp 
file to obtain its information. If a file is 
given, that file is examined. Typically the 
given file will be /tmp/wtmp . which contains a 
record of all the logins since it was created. 
Then who will list all logins and logouts since 
the creation of the wtmp file, 

/tmp/utmp 

login(l), init(VII) 

,, ? ,f if a named file cannot be read. 



dmr, ken 
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3/15/72 



WRITE ( I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNSR 



write — write to another user 

write user 

write copies lines from your typewriter to that 
of another user. When first called, write sends 
the message 

message from yourname... 

The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent. At that point write writes "EOT" 
on the other terminal. 

Permission to write may be denied or granted by 
use of the mescr command. At the outset writing 
is allowed. Certain commands, in particular roff 
and £r f disallow messages in order to prevent 
messy output. 

If the character " l" is found at the beginning of 
a line, write calls the mini-shell msh to execute 
the rest of the line as a command. 

The following protocol' is suggested for using 
write : When you first write to another user, wait 
for him to write back before starting to send. 
Each party should^end^each message with a dis- 
tinctive signal ("(o)" for "over is^ convention- 
al) that the other may reply, "(oo)** (for "over 
and out" ) is suggested when conversation is about 
to be terminated. 



/tmp/utmp 
/etc/msh 



to find user 
to execute ! 



mesg(l), msh(VIl) 
"user not logged in" ; 

dmr, ken 



permission denied 
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3/15/72 



BREAK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



break — set program break 

sys break; addr / break = 17. 

break sets the system's idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 
modification. 

An argument of is taken to mean 8K words. If 
the argument is higher than the stack pointer the 
entire user core area is swapped. 

When a program begins execution via exec the 
break is set at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



exec (II) 

none; strange addresses cause the break to be set 
to include all of core. 



ken , dmr 
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CEMT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



cemt — catch emt traps 

sys cemt; arg / cemt = 2 9. 

This call allows one to catch traps resulting 
from the emt instruction. Arg is a location 
within the program; emt traps are sent to that 
location. The normal effect of emt traps may be 
restored by giving an arg equal to 0. 

Prior to the use of this call, the result of an 
emt instruction is a simulated rts instruction. 
The operand field is interpreted as a register, 
and an rts instruction is simulated for that 
register (after verifying that various registers 
have appropriate values). This feature is useful 
for debugging, since the most dangerous program 
bugs usually involve an rts with bad data on the 
stack or in a register. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ken , dmr 
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3/15/72 CHDIR ( II ) 

NAME chdir — change working directory 

SYNOPSIS sys chdir; dirname / chdir = 12. 

DESCRIPTION dirname is address of the pathname of a directo- 
ry, terminated by a byte, chdir causes this 
directory to become the current working directo- 
ry. 

FILES 

SEE ALSO chdir (I) 

DIAGNOSTICS The error bit (c^-bit) is set if the given name is 

not that of a directory. 

BUGS 

OWNER ken, dmr 
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3/15/72 



CHMOD (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chmod — change mode of file 

sys chmod; name; mode / chmod = 15. 

The file whose name is given as the null- 
terminated string pointed to by name has its mode 
changed to mode . Modes are constructed by oring 
together some combination of the following: 

01 write, non-owner 

02 read, non -owner 
04 write, owner 

10 read, owner 

20 executable 

40 set user ID on execution 

Only the owner of a file (or the super-user) may 
change the mode. 



chmod ( I ) 

Error bit (c-bit) set if name cannot be found or 
if current user is neither the owner of the file 
nor the super-user. 



ken , dmr 
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CHOWN (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



chown — change owner of file 

sys chown; name; owner / chown = 16. 

The file whose name is given by the null- 
terminated string pointed to by name has its own- 
er changed to owner * Only the present owner of a 
file (or the super-user) may donate the file to 
another user. Also, one may not change the owner 
of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses able to misuse 
other's files. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chown(l), uids(V) 

The error bit (c-bit) is set on illegal owner 
changes. 



ken , dmr 
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CLOSE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



close — close a file 

(file descriptor in rO) 
sys close / close = 6. 

Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file, A close of all files is automatic on exit, 
but since processes are limited to 10 simultane- 
ously open files, close is necessary to programs 
which deal with many files. 



creat (II), open ( II) 

The error bit (c-bit) is set for an unknown file 
descriptor. 



ken , dmr 
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3/15/72 



CREAT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



creat — create a new file 

sys creat; name; mode 
(file descriptor in rO) 



/ creat = 8. 



creat creates a new file or prepares to rewrite 
an existing file called name : name is the address 
of a null-terminated string. If the file did not 
exist, it is given mode mode ; if it did exist, 
its mode and owner remain unchanged but it is 
truncated to length. 

The file is also opened for writing, and its file 
descriptor is returned in rO. 

The mode given is arbitrary; it need not allow 
writing. This feature is used by programs which 
deal with temporary files of fixed names. The 
creation is done with a mode that forbids writ- 
ing. Then if a second instance of the program 
attempts a creat , an error is returned and the 
program knows that the name is unusable for the 
moment. 

If the last link to an open file is removed, the 
file is not destroyed until the file is closed. 



write(ll), close(ll) 

The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to be 
created is not writable; the file does exist and 
is unwritable; the file is a directory. 



ken, dmr 



- 1 - 



3/15/72 



EXEC (II) 



NAME exec — execute a file 

SYNOPSIS sys exec; name; args / exec 

• • • 
name: <...\0> 

• • • 

args: argl ; arg2 ; . ..; 
argl : <. . .\0> 



= 11. 



DESCRIPTION 



exec overlays the calling process with the named 
file, then transfers to the beginning of the core 
image of the file. The first argument to e xec is 
a pointer to the name of the file to be executed. 
The second is the address of a list of pointers 
to arguments to be passed to the file. Conven- 
tionally, the first argument is the name of the 
file. Each pointer addresses a string terminated 
by a null byte. 

There can be no return from the file; the calling 
core image is lost. 

The program break is set from the executed file; 
see the format of a. out. 

Once the called file starts execution, the argu- 
ments are passed as follows. The stack pointer 
points to the number of arguments. Just above 
this number is a list of pointers to the argument 
strings. 



sp-> 



nargs 
argl 

... 
argn 



argl : <arg1\0> 

... 
argn: <argn\0> 

The arguments are placed as high as possible in 
core: Just below 60000(8). 

Files remain open across exec calls. However, 
the illegal instruction, emt, quit, and interrupt 
trap specifications are reset to the standard 
values. (See ilgins . cemt, quit , int r. ) 

Each user has a real user ID and an e ffective 
user ID (The real ID identifies the person using 
the system; the effective ID determines his ac- 
cess privileges. ) exec changes the effective user 
ID to the owner of the executed file if the file 
has the "set-user-ID** mode. The real user ID is 
not affected. 



- 1 - 



3/15/72 EXEC (II) 

FILES 

SEE ALSO fork(ll) 

DIAGNOSTICS If the file cannot be read or if it is not exe- 
cutable, a return from exec constitutes the diag- 
nostic. The error bit (c-bit) is set. 

BUGS 

OWNER ken, dmr 



- 2 - 



3/15/72 



EXIT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



exit 



terminate process 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



(status in rO) 

sys exit / exit = 1 

exit is the normal means of terminating a pro- 
cess. All files are closed and the parent pro- 
cess is notified if it is executing a wait. The 
low byte of rO is available as status to the 
parent process. 

This call can never return. 



wait(ll) 



ken f dmr 
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3/15/72 FORK (II) 

NAME fork — spawn new process 

SYNOPSIS sys fork / fork = 2. 

(new process return) 
(old process return) 

DESCRIPTION f ork is the only way new processes are created. 

The new process's core image is a copy of that of 
the caller of f ork ; the only distinction is the 
return location and the fact that rO in the old 
process contains the process ID of the new pro- 
cess. This process ID is used by wait . 

FILES 

SEE ALSO wait (II), exec ( II) 

DIAGNOSTICS The error bit (c-bit) is set in the old process 

if a new process could not be created because of 
lack of process space. 

BUGS See wait (II) for a subtle bug in process destruc- 

tion. 

OWNER ken, drar 
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FSTAT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



fstat — get status of open file 

(file descriptor in rO) 

sys fstat; buf / fstat = 28. 

This call is identical to stat . except that it 
operates on open files instead of files given by 
name. It is most often used to get the status of 
the standard input and output f^les, whose names 
are unknown. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stat (II) 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 



ken, dmr 



- 1 - 



3/15/72 



GETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



getuid — get user identification 

sys getuid / getuid = 24. 
(user ID in rO) 

getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 
effective user ID, which determines his access 
permission at each moment. It is thus useful^to 
programs which operate using the "set user ID** 
mode, to find out who invoked them. 

/etc/uids can be used to map the user ID number 
into a name. 

setuid(ll) 



ken, dmr 
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GTTY (II) 



NAME 
SYNOPSIS 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



gtty — get typewriter status 

(file descriptor in rO) 
sys gtty; arg / gtty = 32. 



arg: .=.+6 



gtty stores in the three words addressed by arg 
the status of the typewriter whose file descrip- 
tor is given in rO. The format is the same as 
that passed by stty . 



stty(ll) 

Error bit (c-bit) is set if the file descriptor 
does not refer to a typewriter. 



ken , dmr 
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3/15/72 HOG (II) 

NAME hog — set program in low priority 

SYNOPSIS sys hog / hog = 34. 

DESCRIPTION The currently executing process is set into the 

lowest priority execution queue. Background jobs 
that execute a very long time should do this, A 
higher priority will be reinstituted as soon as 
the process is dismissed for any reason other 
than quantum overflow, 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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3/15/72 



ILGINS (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ilgins — catch illegal instruction trap 

sys ilgins; arg / ilgins = 33. 

ilgins allows a program to catch illegal instruc- 
tion traps. If arg is zero, the normal instruc- 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arg is 
a location within the program, control is passed 
to arg when the trap occurs. 

This call is used to implement the floating point 
simulator, which catches and interprets 11/45 
floating point instructions. 



fptrap(IIl) 



ken, dmr 
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3/15/72 



INTR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



intr — set interrupt handling 

sys intr; arg / intr = 27. 

When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1 , interrupts cause their 
normal result, that is, force an exit . When arg 
is a location within the program, control is 
transferred to that location when an interrupt 
occurs. 

After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, since all 
I/O is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with characters read, thus simulating an 
end of file. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



quit (II) 



It should be easier to resume after an interrupt, 
but I don't know how to make it work. 

ken , dmr 
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6/12/72 



KILL (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



kill — destroy process 

(process number in rO) 

sys kill / kill = 37. ; not in assembler 

kill destroys a process, given its process 
number. The process leaves a core image. 

This call is restricted to the super-user, and is 
intended only to kill an otherwise unstoppable 
process. 



c-bit set if user is not the super-user, or if 
process does not exist. 

kill has been known to be ineffective. 

ken , dmr 
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3/15/72 LINK (II) 

NAME link — link to a file 

SYNOPSIS sys link; name. ; name 2 / link = 9, 



DESCRIPTION 



A link to name ,, is created; the link has name 
name-* Either name may be an arbitrary path 
name. 



FILES 

SEE ALSO link(l), unlink(ll) 

DIAGNOSTICS The error bit (c-bit) is set when name , cannot be 

found; when name 2 already exists; when the direc- 
tory of name- cannot be written; when an attempt 
is made to link to a directory by a user other 
than the super -user. 

BUGS 

OWNER ken, dmr 
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3/15/72 



MAKDIR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



makdir — make a directory 

sys makdir; name; mode / makdir = 14. 

makdir creates an empty directory whose name is 
the null-terminated string pointed to by n ame * 
The mode^of the directory is m ode . The special 
entries " .' and **.. are not present. 

makdir can only be invoked by the super -user. 



mkdir(l) 

Error bit (c-bit) is set if the directory already 
exists or if the user is not the super-user. 



ken f dmr 
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MDATE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



mdate — set modified date on file 

(time to AC-MQ) 

sys mdate; file / mdate = 30. 

File is the address of a null-terminated string 

giving the name of a file. The modified time of 

the file is set to the time given in the AC-MQ 
registers. 

This call is allowed only to the super-user or to 
the owner of the file. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



Error bit is set if the user is not the super- 
user or if the file cannot be found. 



ken , dmr 
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3/15/72 



MOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



mount — mount file system 

sys mount; special; name / mount = 21. 

mount announces to the system that a removable 
file system has been mounted on special file 
special ; from now on, references to file name 
will refer to the root file on the newly mounted 
file system. Special and name are pointers to 
null-terminated strings containing the appropri- 
ate path names. 

Name must exist already. If it had useful con- 
tents, they are inaccessible while the file sys- 
tem is mounted. 

Almost always, name should be a directory so that 
an entire file system, not just one file, may 
exist on the removable device. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



mount(l), umount(ll) 

Error bit (c-bit) set if special is inaccessible 
or dir does not exist. 

At most two removable devices can be mounted at a 
time. The use of this call should be restricted 
to the super-user. 

ken , dmr 
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OPEN (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



open — open for reading or writing 

sys open; name; mode / open = 5, 
(descriptor in rO) 

open opens the file name for reading ( if mode is 
0) or writing (if mode is non-zero), name is the 
address of a string of ASCII characters 
representing a path name, terminated by a null 
character. 

The file descriptor should be saved for subse- 
quent calls to read (or write) and close. 

In both the read and write case the file pointer 
is set to the beginning of the file. 

If the last link to an open file is removed, the 
file is not destroyed until it is closed. 



FILES 

SEE ALSO 

DIAGNOSTICS 



creat(ll), read(ll), write(ll), close(ll) 

The error bit (c-bit) is set if the file does not 
exist, if one of the necessary directories does 
not exist or is unreadable, or if the file is not 
readable. 



BUGS 
OWNER 



ken , dmr 
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QUIT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



quit — turn off quit signal 

sys quit; flag / quit = 26. 

When flag is 0, this call disables quit signals 
from the typewriter (ASCII FS). When flag is 1, 
quits are re-enabled ,' and cause execution to 
cease and a core image to be produced. When flag 
is an address in the program, a quit causes con- 
trol to be sent to that address. 

Quits should be turned off only with due con- 
sideration. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



intr(Il) 



ken , dmr 
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READ (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



read — 



read from file 



(file descriptor in rO) 

sys read; buffer; nchars / read 

(nread in rO) 



3. 



FILES 

SEE ALSO 

DIAGNOSTICS 



A file descriptor is a word returned from a suc- 
cessful open call. 

Buffer is the location of nchars contiguous bytes 
into which the input will be placed. It is not 
guaranteed that all nchars bytes will be read, 
however; for example if the file refers to a 
typewriter at most one line will be returned. In 
any event the number of characters read is re- 
turned in rO. 

If rO returns with value 0, then end-of-file has 
been reached. 



open (II) 

As mentioned, rO is on return when the end of 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set. Many conditions, all rare, can generate an 
error: physical I/O errors, bad buffer address, 
preposterous nchars . file descriptor not that of 
an input file. 



BUGS 
OWNER 



ken , dmr 
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RELE (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



rele — release processor 

sys rele / rele = 0; not in assembler 

This call causes the process to be swapped out 
immediately if another process wants to run. Its 
main reason for being is internal to the system, 
namely to implement timer-runout swaps. However, 
it can be used beneficially by programs which 
wish to loop for some reason without consuming 
more processor time than necessary. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ken , dmr 
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SEEK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



seek — move read/write pointer 

(file descriptor in rO) 

sys seek; offset; ptrname / seek =19. 

The file descriptor refers to a file open for 
reading or writing. The read (or write) pointer 
for the file is set as follows: 

if ptrname is 0, the pointer is set to o ffset , 

if ptrname is 1 , the pointer is set to its 
current location plus offset . 

if Ptrname is 2, the pointer is set to the 
size of the file plus offset . 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



OWNER 



tell(Il) 

The error bit (c-bit) is set for an undefined 
file descriptor. 

A file can conceptually be as large as 2**20 
bytes. Clearly only 2**16 bytes can be addressed 
by seek . The problem is most acute on the tape 
files and RK and RF. Something is going to be 
done about this. 

ken , dmr 
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SETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



setuid — set process ID 

(process ID in rO) 

sys setuid / setuid = 23. 

The user ID of the current process is set to the 
argument in rO. Both the effective and the real 
user ID are set. This call is only permitted to 
the super-user or if rO is the real user ID. 



getuid(ll) 

Error bit (c-bit) is set if the current user ID 
is not that of the super-user. 



ken , dmr 
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SLEEP (II) 



NAME 
SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sleep — stop execution for interval 

(60ths of a second in rO) 

sys sleep / sleep = 35.; not in assembler 

The current process is suspended from execution 
for the number of 60ths of a second specified by 
the contents of register 0, 



OWNER 



Due to the implementation, the sleep interval is 
only accurate to 2 56 60ths of a second (4.26 
sec). Even then, the process is placed on a low 
priority queue and must be scheduled. 

ken , dmr 
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STAT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stat — get file status 

sys stat; name; buf / stat = 18. 

name points to a null -terminated string naming a 
file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file. It is unnecessary to have any permissions 
at all with respect to the file, but all direc- 
tories leading to the file must be readable. 

After stat . buf has the following format: 



buf, +1 
+2, + 3 
+4 
+5 

+6, +7 
+8, +9 



i-n umber 

flags (see below) 

number of links 

user ID of owner 

size in bytes 

first indirect block or contents block 



+22, +23 eighth indirect block or contents block 
+24, +25, +26, +27 creation time 
+28, +29, +30, +31 modification time 
+32, +33 unused 

The flags are as follows: 

100000 used (always on) 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 



stat(l), fstat(ll) 

Error bit (c-bit) is set if the file cannot be 
found. 

The format is going to change someday, 
ken , dmr 
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STIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stime — set time 

(time in AC-MQ) 

sys stime / stime = 25. 

stime sets the system's idea of the time and 
date. Only the super-user may use this call. 



date(l), time(ll) 

Error bit (c-bit) set if user is not the super- 
user. 



ken , dmr 



- 1 - 



6/12/72 



STTY (II) 



NAME 



SYNOPSIS 



stty 



set mode of typewriter 



(file descriptor in rO) 
sys stty; arg / stty = 31. 
• • • 
arg: dcrsr; dcpsr; mode 



DESCRIPTION 



stty sets mode bits for a typewriter whose file 
descriptor is passed in rO. First, the system 
delays until the typewriter is quiescent. Then, 
the argument dcrsr is placed into the typewri- 
ter's receiver control and status register, and 
dcpsr is placed in the transmitter control and 
status register. The DC-11 manual must be con- 
sulted for the format of these words. For^the 
purpose of this call, the most important role of 
these arguments is to adjust to the speed of the 
typewriter. 

The mode arguments contains several bits which 
determine the system's treatment of the 
typewriter: 

200 even parity allowed on input (e. g. for m37s) 

100 odd parity allowed on input 

040 raw mode: wake up on all characters 

020 map CR into LF; echo LF or CR as LF-CR 

010 echo (full duplex) 

004 map upper case to lower on input (e. g. M33) 

002 echo and print tabs as spaces 

001 inhibit all function delays (e. g. CRTs) 

Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 

In raw mode, every character is passed back im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of-file character (EOT), 
the interrupt character (DELETE) and the quit 
character (.FS) are not treated specially. 

Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 
causes LF-CR both to be echoed (used for GE Ter- 
miNet 300 's and other terminals without the new- 
line function). 

Additional bits in the high order byte of the 
mode argument are used to indicate that the ter- 
minal is an IBM 2741 and to specify 2741 modes. 
These mode bits are: 

400 terminal is an IBM 2741 
1000 the 2741 has the transmit interrupt feature 

(currently ignored) 
2000 use correspondence code conversion on output 
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4000 use correspondence code conversion on input 
(currently ignored) 

Normal input and output code conversion for 2741s 
is EBCDIC (e. g. 963 ball and corresponding key- 
board)* The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 

FILES 

SEE ALSO stty(l), gtty(ll) 

DIAGNOSTICS The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 

BUGS This call should be used with care. It is all 

too easy to turn off your typewriter. 

OWNER ken, dmr 
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SYNC (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



sync — update super-block 

sys sync / sync = 36.; not in assembler 

sync causes the super block for all file systems 
to be written out* It is only necessary on sys- 
tems in which this writing may be delayed for a 
long time, i.e., those which incorporate hardware 
protection facilities. 

It should be used by programs which examine a 
file system, for example check, df, tm, etc. 



ken 
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TELL (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



tell — get file pointer 

(file descriptor in rO) 

sys tell; offset; ptrnarae / tell = 20. 

(value returned in rO) 

The file descriptor refers to an open file. The 
value returned in rO is one of: 

if ptrname is 0, the value returned is offset; 

if ptrname is 1 , the value is the current 
pointer plus o ffset : 

if Ptrname is 2, the value returned is the 
number of bytes in the file plus offset . 



seek (II) 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 

Tell doesn't work. Complain if you need it. 

ken, dmr 
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TIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



time — get time of year 

sys time / time = 13. 
(time AC-MQ) 

time returns the time since 00:00:00, Jan, 1, 
1971, measured in sixtieths of a second. The 
high order word is in the AC register and the low 
order is in the MQ. 



date(l), stime(ll) 



The chronological-minded user will note that 
2**32 sixtieths of a second is only about 2.5 
years. 

ken , dmr 
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UMOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



umount — dismount file system 

sys umount; special / umount = 22. 

umount announces to the system that special file 
special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 
mount ). 

The user must take care that all activity on the 
file system has ceased. 



umount(l), mount (II) 

Error bit (c-bit) set if no file system was 
mounted on the special file. 

Use of this call should be restricted to the 
super -user. 

ken , dmr 
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UNLINK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



OWNER 



unlink — remove directory entry 

sys unlink; name / unlink = 10. 

Name points to a null-terminated string. U nlink 
removes the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 
freed and the file is destroyed. If, however, 
the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 



rm(l), rmdir(l), link(ll) 

The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 
be written. Write permission is not required on 
the file itself. It is also illegal to unlink a 
directory (except for the super-user). 

Probably write permission should be required to 
remove the last link to a file, but this gets in 
other problems (namely, one can donate an un- 
deletable file to someone else). 

If the system crashes while a file is waiting to 
be deleted because it is open, the space is lost. 

ken , dmr 
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WAIT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



wait 



wait for process to die 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



sys wait / wait = 7. 

(process ID in rO) 

(termination status/user status in MQ) 

wait causes its caller to delay until one of its 
child processes terminates. If any child has 
already died, return is immediate; if there are 
no children, return is immediate with the error 
bit set. In the case of several children several 
wait s are needed to learn of all the deaths. 

If the error bit is not set on return, the MQ 
high byte contains the low byte of the child pro- 
cess rO when it terminated. The MQ low byte con- 
tains the termination status of the process from 
the following list: 

exit 

1 bus error 

2 trace trap 

3 illegal instruction 

4 IOT trap 

5 power fail trap 

6 EMT trap 

7 bad system call 

8 quit 

9 interrupt 

10 kill (see kill(ll)) 
+16 core image produced 



exit (II), fork(ll) 

error bit (c-bit) on if no children not previous- 
ly waited for. 

A child which dies but is never waited for is not 
really gone in that it still consumes disk swap 
and system table space. This can make it impos- 
sible to create new processes. The bug can be 
noticed when several w & w separators are given to 
the shell not followed by a command without an 
ampersand. Ordinarily things clean themselves up 
when an ordinary command is typed, but it is pos- 
sible to get into a situation in which no com- 
mands are accepted, so no wait s are done; the 
system is then hung. 

The fix, probably, is to have a new kind of fork 
which creates a process for which no wait is 
necessary (or possible); also to limit the number 
of active or inactive descendants allowed to a 
process. 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



write — write on file 

(file descriptor in rO) 
sys write; buffer; nchars 
(number written in rO) 



/ write = 4. 



A file descriptor is a word returned from a suc- 
cessful open or creat call. 

buffer is the address of nchars contiguous bytes 
which are written on the output file. The number 
of characters actually written is returned in rO. 
It should be regarded as an error if this is not 
the same as requested. 

For disk and tape files, writes which are multi- 
ples of 512 characters long and begin on a 
512-byte boundary are more efficient than any 
others. 



creat (II), open (II) 

The error bit (c-bit) is set on an error: bad 
descriptor, buffer address, or count, physical 
I/O errors; 



ken , dmr 



- 1 



3/15/72 ATAN, ATAN2 (ill) 

NAME atan — arc tangent function 

SYNOPSIS jsr r5,atan[2] 

DESCRIPTION The atan entry returns the arc tangent of frO in 

frO, The range is zero to pi/2. The atan2 entry 
returns the arc tangent of fr0/fr1 in frO. The 
range is -pi to pi. The floating point simula- 
tion should be active in either floating or dou- 
ble mode, but in single precision integer mode, 

FILES kept in /usr/lib/liba. a 

SEE ALSO fptrap(lll) 

DIAGNOSTICS 

BUGS 

OWNER rhm, dmr, ken 
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NAME atof — ascii to floating 

SYNOPSIS jsr r5,atof; subr 

DESCRIPTION atof will convert an ascii stream to a floating 

number returned in frO, The subroutine s ubr is 
called on r5 for each character of the ascii 
stream, subr should return the character in rO. 
The first character not used in the conversion is 
left in rO. The floating point simulation should 
be active in either floating or double mode, but 
in single precision integer mode, 

FILES kept in /usr/lib/liba. a 

SEE ALSO fptrap(lll) 

DIAGNOSTICS 

BUGS The subroutine subr should not disturb any regis- 

ters, 

OWNER ken 
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ATOI (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



atoi — ascii to integer 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



jsr 



r5 f atoi; subr 



atoi will convert an ascii stream to a binary 
number returned in mq. The subroutine s ubr is 
called on r5 for each character of the ascii 
stream. subr should return the character in rO. 
The first character not used in the conversion is 
left in rO. 

kept in /usr/lib/liba. a 



The subroutine subr should not disturb any regis- 
ters. 

ken 
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NAME const — floating point constants 

SYNOPSIS 

DESCRIPTION The following floating point constants are 

correctly represented in double precision. 

one 1.0 

pi2 0.5*3.1415... 

FILES kept in /usr/lib/liba. a 

SEE ALSO fptrap(lll) 

DIAGNOSTICS 

BUGS 

OWNER rhm, dmr, ken 
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CTIME (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ctime — convert date and time to ASCII 

(move time to AC-MQ) 
mov $buffer,rO 
jsr pc, ctime 

The buffer is 1 5 characters long. The time has 
the format 

Oct 9 17:32:24 

The input time is in the AC and MQ registers in 
the form returned by sys time . 

kept in /usr/lib/liba. a 

ptime(lll), time(ll) 



dmr 



- 1 - 



3/15/72 



EXP (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



exp — exponential function 

jsr r5,exp 

The exponential of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba. a 

fptrap(IIl) 

The c-bit is set if the result is not represent- 
able. 



rhm , dmr , ken 
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FPTRAP (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



fptrap — PDP-11/45 floating point simulator 

•globl fptrap 

sys ilgins; fptrap 

fptrap is a package which picks up instructions 
which are illegal for the PDP-11/20, and if they 
correspond to 11/45 floating point instructions, 
simulates their operation. The following in- 
structions are supported: 



cfcc 






setf 






seti 






setd 






setl 






clrf 


fdst 




tstf 


fsrc 




absf 


fdst 




negf 


fdst 




mulf 


f src,fr 




modf 


f src,fr 




addf 


fsrc,fr 




movf 


f src,fr 


(-ldf) 


movf 


fr,fdst 


(=stf) 


subf 


f src,f r 




cmpf 


f src,fr 




divf 


fsrc,fr 




movf i 


fr,dst 


(=stcf i) 


movif 


src,fr 


(=ldcif ) 


movfo 


fr,fdst 


(=stcxy ) 


movof 


f src,fr 


(=ldcyx) 



Here src and dst stand for source and destina- 
tion, fsrc and fdst for floating source and des- 
tination, and fr for floating register. Notice 
that the names of several of the opcodes have 
changed. The only strange instruction is movf . 
which turns into stf if its source operand is a 
floating register, and into ldf if not. 

The simulator sets the floating condition codes 
on both ldf and stf . The 11/45 hardware does not 
set the fee on stf. 

Short and long format for both floating point 
numbers and integers is supported. Truncation 
mode is always in effect. Traps for overflow and 
other arithmetic errors are not supported. Ille- 
gal instructions or addresses cause a simulated 
trap so that a core image is produced. 

The condition code bits are maintained correctly. 

For floating-point source operands, immediate 
mode ((pc)+) is not supported, since the 
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FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



PDP-11/45 handbook is not clear on what to do 
about it. 

After an arithmetic error the result is generally 
meaningless. 

The arithmetic is always done in double- 
precision, so exact but unrounded results are to 
be expected in single-precision mode. Double 
precision results are probably less correct than 
the hardware will be. 

The lower parts of the floating registers become 
meaningless during single-precision operations. 

kept in /usr/lib/liba. a 

PDP-11/45 handbook, ilgins(ll) 

trap, c-bit, v-bit 

see above 

ken, dmr 
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FTOA (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



f toa — floating to ascii conversion 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



jsr 



r5,ftoa; subr 



f toa will convert the floating point number in 
frO into ascii in the form [-]d.dddddddde[-]dd*. 
The floating point simulator should be active in 
either floating or double mode, but in single 
integer mode. For each character generated by 
ftoa, the subroutine subr is called on register 
r5 with the character in rO. 

kept in /usr/lib/liba. a 

fptrap(lll) 



The subroutine subr should not disturb any regis- 
ters. 

ken 
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CONNECT, GERTS (III) 



NAME 
SYNOPSIS 



connect, gerts — Gerts communication over 201 

jsr r 5, connect 
(error return)/ 



jsr r 5, gerts; fc; oc; ibuf ; obuf 
(error return) 



DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



The GECOS GERTS interface is so bad that a 
description here is inappropriate. Anyone need- 
ing to use this interface should contact the own- 
er. 

/dev/dnO, /dev/dpO 
kept in /usr/lib/liba. a 

dn(lV), dp (IV), HIS documentation 



ken 
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GETC, GETW, FOPEN (ill) 



NAME 
SYNOPSIS 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



getw, getc, fopen — buffered input 

mov $filename,rO 

j sr r 5 , fopen ; iobuf 

jsr r 5, getc; iobuf 
(character in rO) 

jsr r 5, getw; iobuf 
(word in rO) 

These routines are used to provide a buffered 
input facility, iobuf is the address of a 
518(10) byte buffer area whose contents are main- 
tained by these routines. Its format is: 



ioptr: 



. = .+2 
. = . + 2 
. = .+2 
.=.+512. 



/ file descriptor 
/ characters left in buffer 
/ ptr to next character 
/ the buffer 



fopen may be called initially to open the file. 
On return, the error bit (c-bit) is set if the 
open failed. If fopen is never called, get will 
read from the standard input file. 

getc returns the next byte from the file in rO. 
The error bit is set on end of file or a read 
error. 

getw returns the next word in rO. getc and getw 
may be used alternately; there are no odd/ even 
problems. 

iobuf must be provided by the user; it must be on 
a word boundary. 

kept in /usr/lib/liba. a 

open (II), read (II), putc(III) 

c-bit set on EOF or error 



dmr 
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HYPOT (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



hypot — calculate hypotenuse 

(A in frO) 
(B in frO) 
jsr r 5, hypot 

The square root of frO*frO + fr1*fr1 is returned 
in frO. The calculation is done in such a way 
that overflow will not occur unless the answer is 
not representable in floating point. 

The floating point simulator should be active in 
either single or double mode. 

kept in /usr/lib/liba. a 

fptrap(lll) 

The c-bit is set if the result cannot be 
represented. 



ken , dmr 
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ITOA (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



itoa — integer to ascii conversion 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



jsr 



r 5, itoa; subr 



itoa will convert the number in rO into ascii 
decimal possibly preceded by a - sign. For each 
character generated by itoa, the subroutine subr 
is called on register r5 with the character in 
rO. 

kept in /usr/lib/liba. a 



The subroutine subr should not disturb any regis- 
ters. 

ken 
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LOG (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



log — logarithm base e 

jsr r5,log 

The logarithm base e of frO is returned in frO. 
The floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba. a 

f ptrap 

The error bit (c-bit) is set if the input argu- 
ment is less than or equal to zero. 



ken 
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NAME mesg — write message on typewriter 

SYNOPSIS jsr r 5, mesg; <Now is the time\0> ; .even 

DESCRIPTION mesg writes the string immediately following its 

call onto the standard output file. The string 
is terminated by a byte. 

FILES kept in /usr/lib/liba. a 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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NAME nlist — get entries from name list 

SYNOPSIS jsr r5, nlist; file; list 

• • • 

file: <file name\0> 

list: 

<name1xxx>; typel ; valuel 
<name2xxx> ; type2 ; value2 

• • • 




DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



nlist will examine the name list in an assembler 
output file and selectively extract a list of 
values. The file name is a standard UNIX path 
name. The name list consists of a list of 8- 
character names (null padded) each followed by 
two words. The list is terminated with a zero. 
Each name is looked up in the name list of the 
file. If the name is found, the type and value 
of the name are placed in the two words following 
the name. If the name is not found, the type 
entry is set to -1 • 

This subroutine is useful for examining the sys- 
tem name list kept in the file /sys/sys/unix. In 
this way programs can obtain system 'magic' 
numbers that are up to date. 

kept in /usr/lib/liba. a 

a.out(V) 

All type entries are set to -1 if the file cannot 
be found or if it is not a valid namelist. 



ken 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ptime — print date and time 

(move time to ac-mq) 
mov file,rO 
jsr pc, ptime 

ptime prints the date and time in the form 

Oct 9 17:20:33 

on the file whose file descriptor is in rO. The 
string is 1 5 characters long. The time to be 
printed is placed in the AC and MQ registers in 
the form returned by sys time * 

kept in /usr/lib/liba. a 

time (II), ctime(lll) (used to do the conversion) 



see ctime 
dmr • ken 
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NAME 
SYNOPSIS 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



PUTC, PUTW, FCREAT, FLUSH (III) 



putc, putw, fcreat, flush — buffered output 

raov $filename,rO 
jsr r 5, fcreat; iobuf 

(get byte in rO) 

jsr r 5 , putc ; iobuf 

(get word in rO) 

jsr r 5, putw; iobuf 



Jsr 



r 5, flush; iobuf 



fcreat creates the given file (mode 17) and sets 
up the buffer iobuf (size 518(10) bytes); putc 
and putw write a byte or word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file. The 
format of the buffer is: 



iobuf : 



. = .+2 
. = .+2 
. = .+2 
.=.+512. 



/ file descriptor 
/ characters unused in buffer 
/ ptr to next free character 
/ buffer 



fcreat sets the error bit (c-bit) if the file 
creation failed; none of the other routines re- 
turn error information. 

Before terminating, a program should call f lush 
to force out the last of the output. 

The user must supply iobuf, which should begin on 
a word boundary. 

kept in /usr/lib/liba. a 

creat(ll), write(ll), getc(lll) 

error bit possible on fcreat call 



dmr 
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QSORT ( III) 



NAME 
SYNOPSIS 



DESCRIPTION 



qsort — quicker sort 

(base of data in r1 ) 
(end of data in r2 ) 
(element width in r3) 
jsr pc, qsort 

qsort is an implementation of the quicker sort 
algorithm. It is designed to sort equal length 
byte strings. Registers r1 and r2 delimit the 
region of core containing the array of byte 
strings to be sorted: r1 points to the start of 
the first string, r2 to the first location above 
the last string. Register r3 contains the length 
of each string. r2-r1 should be a multiple of 
r3. On return, rO , r1 , r2, r3, r4 , AC and MQ are 
destroyed. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



The user should be able to supply his own compar- 
ison routine. 

ken 
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S ALLOC (III) 



NAME 
SYNOPSIS 



salloc ~ string manipulation routines 

(get size in rO) 
sr pc, allocate 

get source pointer in rO, 
destination pointer in rl) 
sr pc,copy 

sr pc,wc 

all following instructions assume r1 contains pointer) 

sr pc 9 release 

get character in rO) 
sr pc, put char 

sr pc f lookchar 

character in rO) 

sr pc, get char 

character in rO) 

get character in rO) 
sr pc f alterchar 

get position in rO) 
sr pc,seekchar 

sr pc, backspace 

character in rO; 

get word in rO) 
sr pc,putword 

j sr pc , lookword 

(word in rO) 

jsr pc, get word 

(word in rO) 

(get word in rO) 
jsr pc,alterword 

j sr pc , backword 

(word in rO) 

jsr pc, length 

(length in rO) 

jsr pc, position 

(position in rO) 



jsr 



pc, rewind 
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6/15/72 SALLOC (III) 

jsr pc, create 

jsr pc,fsfile 

jsr pc,zero 

DESCRIPTION This package is a complete set of routines for 

dealing with almost arbitrary length strings of 
words and bytes • The strings are stored on a 
disk file, so the sum of their lengths can be 
considerably larger than the available core. 

For each string there is a header of four words, 
namely a write pointer, a read pointer and 
pointers to the beginning and end of the block 
containing the string* Initially the read and 
write pointers point to the beginning of the 
string* All routines that refer to a string 
require the header address in r1* unless the 
string is destroyed by the call, upon return r1 
will point to the same string, although the 
string may have grown to the extent that it had 
to be be moved. 

allocate obtains a string of the requested size 
and returns a pointer to its header in r1. 

release releases a string back to free storage. 

put char and putword write a byte or word respec- 
tively into the string and advance the write 
pointer. 

lookchar and lookword read a byte or word respec- 
tively from the string but do not advance the 
read pointer* 

get char and qetword read a byte or word respec- 
tively from the string and advance the read 
pointer* 

alter char and alterword write a byte or word 
respectively into the string where the read 
pointer is pointing and advance the read pointer* 

backspace and backword read the last byte or word 
written and decrement the write pointer* 

All write operations will automatically get a 
larger block if the current block is exceeded* 
All read operations return with the error bit set 
if attempting to read beyond the write pointer. 

seek char moves the read pointer to the offset 
specified in rO* 

- 2 - 



6/1 5/72 



SALLOC (III) 



FILES 



length returns the current length of the string 
(beginning pointer to write pointer) in rO. 

position returns the current offset of the read 
pointer in rO. 

rewind moves the read pointer to the current 
position of the write pointer* 

create returns the read and write pointers to the 
beginning of the string. 

f sf ile moves the write pointer to the current 
position of the read pointer. 

zero zeros the whole string and sets the write 
pointer to the beginning of the string. 

copy copies the string whose header pointer is in 
rO to the string whose header pointer is in r1. 
Care should be taken in using the copy instruc- 
tion since r1 will be changed if the contents of 
the source string is bigger than the destination 
string. 

wc forces the contents of the internal buffers 
and the header blocks to be written on disc. 

The allocator proper is in /usr/llc/alloc/alloca. 

The archive /usr/llc/alloc/allocb contains the 
individual routines discussed above. 

alloc.d is the temporary file used to contain the 
strings. 



SEE ALSO 
DIAGNOSTICS 



error in copy if a disk write error occurs dur- 
ing the execution of the copy instruction. 

error in allocator" if any routine is called 
with w a bad header pointer, "cannot open output 
file" if file alloc.d cannot be created or 
opened^ "out of space" if there's no available 
block of the requested size or no headers avail- 
able for a new block. 



BIX3S 
OWNER 



llc,rhm 
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SIN, COS (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



sin, cos — sine cosine 

jsr r5,sin (cos) 

The sine (cosine) of frO (radians) is returned in 
frO, The floating point simulation should be 
active in either floating or double mode, but in 
single precision integer mode. All floating 
registers are used, 

kept in /usr/lib/liba, a 

fptrap(lll) 



Size of the argument should be checked to make 
sure the result is meaningful. 

ken , dmr 
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SQRT (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



sqrt — square root function 

jsr r5,sqrt 

The square root of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode. 

kept in /usr/lib/liba. a 

fptrap(HI) 

The c-bit is set on negative arguments. 

rhm, dmr, ken 
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NAME switch — switch on value 

SYNOPSIS (switch value in rO) 

jsr r5, switch; swtab 
(not-found return) 

• • • 
swtab: vail ; labl ; 

• • • 

vain; labn 
. . ; 

DESCRIPTION switch compares the value of rO against each of 

the val.; if a match is found, control is 
transferred to the corresponding lab. (after pop- 
ping the stack once). If no match his been found 
by the time a null lab. occurs, switch returns. 

FILES kept in /usr/lib/liba. a 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken , dmr 
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NAME dnO — dn-11 ACU interface 

SYNOPSIS — 

DESCRIPTION dnO is a write-only file. Bytes written on dnO 

must be ASCII digits. Each digit corresponds to 
a digit of a telephone number to be called. The 
entire telephone number must be presented in a 
single write system call. The call must complete 
with the last digit. 

FILES found in /dev 

SEE ALSO dpO(lV), write(ll) 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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DP (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



dpO — dp-11 201 data-phone interface 



dpO is a 201 data-phone interface file. r ead and 
write calls to dpO are limited to a maximum of 
400 bytes. Each write call is sent as a single 
record. Seven bits from each byte are written 
along with an eighth odd parity bit. The sync 
must be user supplied. Each read call returns 
characters received from a single record. Seven 
bits are returned unaltered; the eighth bit is 
set if the byte was not received in odd parity. 
A 20 second time out is set and a zero byte 
record is returned if nothing is received in that 
time. 

found in /dev 

dnO(IV), gerts(HI) 



The dp file is GECOS oriented. It should be more 
flexible. 

ken , dmr 
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LPR (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/dev/lpr — line printer 



The line printer special file is the UNIX inter- 
face to a DEC LP-1 1 line printer. This file may 
only be opened (or creat'ed) for writing. Any- 
thing written on this file is printed on the line 
printer. The following special cases for the 
printer are handled: 

On opening and on closing, the paper is slewed 
to the top of the next page. 

For the 64 character printer (LP11-FA), all 
lower case letters are converted to upper 
case. 

Tabs are converted to align on every eighth 
column. 

New lines and form feeds are ignored when the 
printer is at the top of a page. This is done 
so that £r and roff output may be directed to 
the printer and sync on page boundaries even 
with automatic page slew. 

Carriage return and back space can cause mul- 
tiple printing on a single line to allow for 
over struck graphics. 

found in /dev 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



mem — core memory 



mem maps the core memory of the computer into a 
file. It may be used, for example, to examine, 
and even to patch the system using the debugger. 

Mem is a byte-oriented file; its bytes are num- 
bered to 65,535. 

found in /dev 



OWNER 



If a location not corresponding to implemented 
memory is read or written, the system will incur 
a bus -error trap and, in panic, will reboot it- 
self. 

ken , dmr 
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NAME mtO — magtape 

SYNOPSIS 

DESCRIPTION mtO is the DEC TU10/TM11 magtape. When opened 

for reading or writing, the magtape is rewound. 
A tape consists of a series of 256 word records 
terminated by an end-of-file. Reading less than 
2 56 words (512 bytes) causes the rest of a record 
to be ignored. Writing less than a record causes 
null padding to 512 bytes. When the magtape is 
closed after writing, an end-of-file is written. 

Seek has no effect on the magtape. The magtape 
can only be opened once at any instant. 

FILES found in /dev 

SEE ALSO mt(l) 

DIAGNOSTICS 

BUGS Seek should work on the magtape. Also, a provi- 

sion of having the tape open for reading and 
writing should exist. A multi-file and multi- 
reel facility should be incorporated. 

OWNER ken, dmr 
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PPT (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ppt — punched paper tape 



ppt refers to the paper tape reader or punch, 
depending on whether it is read or written. 

When ppt is opened for writing, a 100-character 
leader is punched. Thereafter each byte written 
is punched on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
100-character trailer is punched. 

When ppt is opened for reading, the process waits 
until tape is placed in the reader and the reader 
is on-line. Then requests to read cause the 
characters read to be passed back to the program, 
again without any editing. This means that 
several null characters will usually appear at 
the beginning of the file; they correspond to the 
tape leader. Likewise several nulls are likely 
to appear at the end. End-of-file is generated 
when the tape runs. out. 

Seek calls for this file are meaningless and are 
effectively ignored (however, the read/write 
pointers are maintained and an arbitrary sequence 
of reads or writes intermixed with seeks will 
give apparently correct results when checked with 
tell ). 

found in /dev 



ken , dmr 
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RFO (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



rfO 



— RF11-RS11 fixed-head disk file 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OWNER 



This file refers to the entire RF disk. It may 
be either read or written, although writing is 
inherently very dangerous, since a file system 
resides there. 

The disk contains 1024 256-word blocks, numbered 
to 1023. Like the other block-structured dev- 
ices (tape, RK disk) this file is addressed in 
blocks, not bytes. This has two consequences: 
seek calls refer to block numbers, not byte 
numbers; and sequential reading or writing always 
advance the read or write pointer by at least one 
block. Thus successive reads of 1 characters 
from this file actually read the first 10 charac- 
ters from successive blocks. 

found in /dev 

tapO(lV), rkO(lV) 



The fact that this device is addressed in terms 
of blocks, not bytes, is extremely unfortunate. 
It is due entirely to the fact that read and 
write pointers (and consequently the arguments to 
seek and tell ) are single-precision numbers. 
This really has to be changed but unfortunately 
the repercussions are serious. 

ken, dmr 
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NAME rkO — RK03 (or RK05) disk 

SYNOPSIS 

DESCRIPTION rkO refers to the entire RK03 disk as a single 

sequentially- addressed file. Its 2 56-word blocks 
are numbered to 4871. Like the RF disk and the 
tape files, its addressing is block-oriented. 
Consult the rfO(lV) section. 

FILES found in /dev 



SEE ALSO 


rfO(lV), ta 


DIAGNOSTICS 


— 


BUGS 


See rfO(lV) 


OWNER 


ken , dmr 
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RPO (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



rpO — RP11/RP02 disk 



rpO refers to the entire RP02 disk as a single 
sequentially-addressed file. Its 256-word blocks 
are numbered to 40599. Like the RF disk and 
the tape files, its addressing is block-oriented. 
Consult the rfO(IV) section. 

found in /dev 



rfO(lV), tapO(lV) 



See rf0(iv) 

Due to a hardware bug, block 40599 on the RP can- 
not be accessed. 

ken , dmr 



- 1 - 



3/15/72 



TAPO 



TAP7 (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tapO • • . tap7 



These files refer to DECtape drives to 7, 
Since the logical drive number can be manually 
set, all eight files exist even though at present 
there are fewer physical drives. 

The 2 56-word blocks on a standard DECtape are 
numbered to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth- 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 

Like the RK and RF special files, addressing on 
the tape files is block-oriented. See the RFO 
section. 

found in /dev 

/dev/rfO, /dev/rkO 



see /dev/rfO 

ken , dmr 
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TTY (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tty — console typewriter 



tty (as distinct from ttvO . • «,, ttyn ) refers to 
the console typewriter hard-wired to the PDP-11. 

Generally, the disciplines involved in dealing 
with tty are similar to those for t tvO . • • and 
the appropriate section should be consulted. The 
following differences are salient: 

The system calls stty and gtty do not apply to 
this device. It cannot be placed in raw mode; on 
input, upper case letters are always mapped into 
lower case letters; a carriage return is echoed 
when a line-feed is typed. 

The quit character is not FS (as with ttvO . , . ) 
but is generated by the key labelled "alt mode.*' 

By appropriate console switch settings, it is 
possible to cause UNIX to come up as a single- 
user system with I/O on this device, 

found in /dev 

ttyO(lV), init(VIl) 



ken, dmr 
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TTYO (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



ttyO ... tty7 — communications interfaces 



These files refer to DC11 asynchronous communica- 
tions interfaces. At the moment there are eight 
of them, but the number is subject to change. 

When one of these files is opened, it causes the 
process to wait until a connection is esta- 
blished. (In practice, however, user's programs 
seldom open these files; they are opened by in it 
and become a user's standard input and output 
file. ) The very first typewriter file open in a 
process becomes the control typewriter for that 
process. The control typewriter plays a special 
role in handling quit or interrupt signals, as 
discussed below. The control typewriter is in- 
herited by a child process during a fork . 

A terminal associated with one of these files 
ordinarily operates in full-duplex mode. Charac- 
ters may be typed at any time, even while output 
is occurring, and are only lost when the system's 
character input buffers become completely choked, 
which is rare, or when the user has accumulated 
the maximum allowed number of input characters 
which have not yet been read by some program. 
Currently this limit is 150 characters. When 
this is happening the character " f n is echoed for 
every lost input character. 

When first opened, the standard interface mode 
assumed includes: ASCII characters; .150 baud; 
even parity accepted; 10 bits/character (one stop 
bit); and newline action, character. The system 
delays transmission after sending certain func- 
tion characters; delays for horizontal tab, new- 
line, and form feed are calculated for the Tele- 
type Model 37; the delay for carriage return is 
calculated for the GE TermiNet 300. Most of 
these operating states can be changed by using 
the system call stty(ll). In particular the fol- 
lowing hardware states are program settable in- 
dependently for input and output (see DC11 
manual): 110, 134.5, 150, 300, 600, or 1200 baud; 
one or two stop bits on output; and 5, 6, 7, or 8 
bits/ character. In addition, the following 
software modes can be invoked: acceptance of even 
parity, odd parity, or both; a raw mode in which 
all characters may be read one at a time; a car- 
riage return (CR) mode in which CR is mapped into 
newline on input and either CR or line feed (LF) 
cause echoing of the sequence LF-CR; mapping of 
upper case letters into lower case; suppression 
of echoing; suppression of delays after function 
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characters; the echoing of input tabs as spaces; 
and setting the system to handle IBM 2741 s. See 
getty(VIl) for the way that terminal speed and 
type are detected. 

Normally, typewriter input is processed in units 
of lines • This means that a program attempting 
to read will be suspended until an entire line 
has been typed. Also, no matter how many charac- 
ters are requested in the read call, at most one 
line will be returned. It is not however neces- 
sary to read a whole line at once; any number of 
characters may be requested in a read, even one, 
without losing information. 

During input, erase and kill processing is nor- 
mally done. The character "# erases the last 
character typed, except that it will not erase 
beyond the tt beginning of a line or an EOF. The 
character "%" kills the entire line up to the 
point where it was typed, but not beyond an EOF. 
Both these characters operate on a keystroke 
basis independently of any backspacing or tabbing 
that may have been done. Either "s" or jj#" may 
be entered literally by preceding it by "^"^ the 
erase or kill character remains, but the \ 
disappears. 

It is possible to use raw mode in which the pro- 
gram reading is wakened on each character. The 
program waits only until at least one character 
has been typed. In raw mode, no erase or kill 
processing is done; and the EOT, quit and inter- 
rupt characters are not treated specially. 

The ASCII EOT character may be used to generate 
an end of file from a typewriter. When an EOT is 
received, all the characters waiting to be read 
are immediately passed to the program, without 
waiting for a new -line. Thus if there are no 
characters waiting, which is to say the EOT oc- 
curred at the beginning of a line, zero charac- 
ters will be passed back, and this is the stan- 
dard end-of-f ile signal. 

When the carrier signal from the dataset drops 
(usually because the user has hung up his termi- 
nal) any read returns with an end-of-f ile indica- 
tion. Thus programs which read a typewriter and 
test for end-of-f ile on their input can terminate 
appropriately when hung up on. 

Two characters have a special meaning when w typed. 
The^ASCII DEL character (sometimes called "rub- 
out") is the interrupt signal. When this charac- 
ter is received from a given typewriter, a search 
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is made for all processes which have this type- 
writer as their control typewriter, and which 
have not informed the system that they wish to 
ignore interrupts. If there is more than one 
such process, one of these is selected, for prac- 
tical purposes at random. If interrupts aren't 
being ignored, the process is either forced to 
exit or a trap is simulated to an agreed-upon 
location in the process. See intr(ll). 

The ASCII character FS is the quit signal. Its 
treatment is identical to the interrupt signal 
except that unless the receiving process has made 
other arrangements it will not only be terminated 
but a core image file will be generated. See 
quit(ll). 

Output is prosaic compared to input* When one or 
more characters are written, they are actually 
transmitted to the terminal as soon as 
previously-written characters have finished typ- 
ing. Input characters are echoed by putting them 
in the output queue as they arrive. When a pro- 
gram produces characters more rapidly than they 
can be typed, it will be suspended when its out- 
put queue exceeds some limit. When the queue has 
drained down to some threshold the program is 
resumed. Even parity is always generated on out- 
put. The EOT character is not transmitted to 
prevent terminals which respond to it from being 
hung up. 

The system will handle IBM 2741 terminals. See 
getty(VII) for the way that 2741s are detected. 
In 2741 mode, the hardware state is: 134.5 baud; 
one output stop bit; and 7 bits/character. Be- 
cause the 2741 is inherently half -duplex, input 
is not echoed. Proper function delays are pro- 
vided. For 2741s without a feature known as 
"transmit interrupt"* it is not possible to col- 
lect input ahead of the time that a program reads 
the typewriter, because once the keyboard has 
been enabled there is no way to send further out- 
put to the 2741. It is currently assumed that 
the feature is absent; thus the keyboard is un- 
locked only when some program reads. The inter- 
rupt signal (normally ASCII DEL) is simulated 
when the 2741 "attention" key is pushed to gen- 
erate either a 2741 style EOT or a break. It is 
not possible to generate anything corresponding 
to the end-of-file EOT or the quit signal. 
Currently IBM EBCDIC is default for input and 
output; correspondence code output is settable 
(see stty(l)). The full ASCII character set is 

~' It r It tt _ »I M r «f ft « t» t» *«»tt 

not available: [ , J , { , } , , are miss- 
ing on input and are printed as blank on output; 
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<p is used for \ ; -» for ; f for both 
and on output; and T maps into on 
input. Similar mappings occur with correspon- 
dence code output. 

FILES found in /dev 

SEE ALSO tty(l), getty(VIl) 

DIAGNOSTICS 

BUGS The primarily Model 37 oriented delays may not be 

appropriate for all other ASCII terminals. 

OWNER ken, dmr, jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



a. out — assembler and link editor output 



a, out is the output file of the assembler as and 
the link editor Id. In both cases , a . out is exe- 
cutable provided there were no errors and no 
unresolved external references. ' 

This file has four sections: a header, the pro- 
gram and data text, a symbol table, and reloca- 
tion bits (in that order). The last two may w be 
empty if the program was loaded with the "-s 
option of Id or if the symbols and relocation 
have been removed by strip ./ 

The header always contains 8 words: 

1 a "br .+20™ instruction (407(8)) 

2 The size of the program text segment 

3 The size of the initialized data segment 

4 The size of the uninitialized (bss) segment 

5 The size of the symbol table 

6 The entry location (always at present) 

7 The stack size required (0 at present) 

8 A flag indicating relocation bits have been 
suppressed 

The sizes of each segment are in bytes but are 
even. The size of the header is not included in 
any of the other sizes. 

When a file produced by the assembler or loader 
is loaded into core for execution, three logical 
segments are set up: the text segment, the data 
segment, and the uninitialized segment, in that 
order. The text segment begins at the lowest 
location in the core image; the header is not 
loaded. The data segment begins immediately 
after ther text segment, and the bss segment im- 
mediately after the data segment. The bss seg- 
ment is/ initialized by 0's. In the future the 
text segment will be write-protected and shared. 

The start of the text segment in the file is 
20(8); the start of the data segment is 20+S 
(the size of the text) the start of the reloca- 
tion information is 20+S.+S ; the start of the 
symbol table is 20+2 (S +§,) if the relocation 
information is present, 20+S.+S, if not. 

The symbol table consists of 6-word entries. The 
first four contain the ASCII name of the symbol, 
null-padded. The next word is a flag indicating 
the type of symbol. The following values are 
possible: 
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00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

40 undefined external (.globl) symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

Values other than those given above may occur if 
the user has defined some of his own instruc- 
tions. 

The last word of a symbol table entry contains 
the value of the symbol. 

If the symbol's type is undefined external, and 
the value field is non-zero, the symbol is inter- 
preted by the loader Id as the name of a common 
region whose size is indicated by the value of 
the symbol • 

If a, out contains no unresolved global refer- 
ences, the text portions are exactly as they will 
appear in core when the file is executed. If the 
value of a word in the text portion involves a 
reference to an undefined global, the word is 
replaced by the offset to be added to the 
symbol's value when it becomes defined. 

If relocation information is present, it amounts 
to one word per word of program text or initial- 
ized data. There is no relocation information if 
the "suppress relocation' flag in the header is 
on. 

Bits 3-1 of a relocation word indicate the seg- 
ment referred to by the text or data word associ- 
ated with the relocation word: 

00 indicates the reference is absolute 

02 indicates the reference is to the text seg- 
ment 

04 indicates the reference is to the data seg- 
ment 

06 indicates the reference is to the bss seg- 
ment 

1 indicates the reference is to an undefined 
external symbol. 

Bit of the relocation word indicates if on that 
the reference is relative to the pc (e,g, clr 
x" ) ; if off ft the reference is to the actual sym- 
bol (e.g., clr *$x"). 

- 2 - 



3/15/72 A. OUT (V) 

The remainder of the relocation word (bits 15-4) 
contains a symbol number in the case of external 
references, and is unused otherwise* The first 
symbol is numbered 0, the second 1, etc, 

FILES 

SEE ALSO as Id, strip , nm, un ( I ) 

DIAGNOSTICS 

BUGS 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



archive (library) file format 



The archive command ar is used to combine several 
files into one. Its use has three benefits: when 
files are combined, the file soace consumed by 
the breakage at the end of each file (256 bytes 
on the average) is saved; directories are smaller 
and less confusing; archive files of object pro- 
grams may be searched as libraries by the loader 
Id. 

A file produced by ar has a "magic number" at the 
start, followed by the constituent files, each 
preceded by a file header. The magic number is 
-147(10), or 177555(8) (it was chosen to be un- 
likely to occur anywhere else). The header of 
each file is 16 bytes long; 

0-7 

file name, null padded on the right 

8-11 

Modification time of the file 



12 



13 



User ID of file owner 



file mode 



14-15 

file size 

If the file is an odd number of bytes long, it is 
padded with a null byte, but the size in the 
header is correct. 

Notice there is no provision for empty areas in 
an archive file. 



ar, 



Id 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



format of core image 



Three conditions cause UNIX to write out the core 
image of an executing program: the program gen- 
erates an unexpected trap (by a bus error or n 
illegal instruction); the user sends a "quit" 
signal (which has not been turned off by the 
program); a trap is simulated by the floating 
point simulator. The core image is called "core" 
and is written in the current working directory 
(provided it can be; normal access controls ap- 
ply). 

The size and structure of the core image file 
depend to some extent on which system is in- 
volved. In general there is a 512-byte area at 
the end which contains the system's per-process 
data for that process. The remainder represents 
the actual contents of the user's core area when 
the core image was written. In the current sys- 
tem, this area is variable in size in that only 
the locations from user to the program break, 
plus the stack, is dumped. 

When any trap which is not an I/O interrupt oc- 
curs, all the useful registers are stored on the 
stack. After all the registers have been stored, 
the contents of S£ are placed in the first cell 
of the user area; this cell is called u. sp . 
Therefore, within the core image proper, there is 
an area which contains the following registers in 
the following order (increasing addresses): 

(u.sp)->sc 
mq 
ac 
r5 
r4 
r3 
r2 
r1 
rO 

pc (at time of fault) 
processor status (at time of fault) 

The last two are stored by the hardware. It fol- 
lows that the contents of so at the time of the 
fault were (u.sp) plus 22(10). 

The actual location of this data depends on which 
system is being used. In the current system, 
which has relocation and protection hardware, the 
stack discussed above is the system stack, and is 
kept in the per-user area; in older systems, 
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FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



there is only one stack, and it is located in the 
user's core area. 

In general the debugger db(l) should be used to 
deal with core images. 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



format of directories 



A directory behaves exactly like an ordinary 
file, save that no user may write into a directo- 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node 
entry. 

Directory entries are 10 bytes long. The first 
word is the i-node of the file represented by the 
entry, if non-zero; if zero, the entry is empty. 

Bytes 2-9 represent the (8-character) file name, 
null padded on the right. These bytes are not 
necessarily cleared for empty slots. 

By convention, the^first two entries in each 
directory are for "." and * , ., w . The first is an 
entry for the directory itself. The second is 
for the parent directory. The meaning of w •. ,, is 
modified for the root directory of the master 
file system and for the root directories of re- 
movable file systems. In the first case, there 
is no parent, and in the second, the system does 
not permit off -device references without a mount 
system call. Therefore in both cases * , ,. w has 
the same meaning as " .** • 



file system format 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



format of file system 



Every file system storage volume (e.g. RF disk, 
RK disk, DtCtape reel) has a common format for 
certain vital information. 

Every such volume is divided into a certain 
number of 256 word (512 byte) blocks. Blocks 
and 1 are collectively known as the super - block 
for the device; they define its extent and con- 
tain an i-node map and a free-storage map. The 
first word contains the number of bytes in the 
free-storage map; it is always even. It is fol- 
lowed by the map. There is one bit for each 
block on the device; the bit is "l" if the block 
is free. Thus if the number of free-map bytes is 
n, the blocks on the device are numbered 
through 8n-1 . The free-map count is followed by 
the free map itself. The bit for block k of the 
device is in byte k/8 of the map; it is offset 
k(mod 8) bits fronTthe right. Notice that bits 
exist for the superblock and the i-list, even 
though they are never allocated or freed. 

After the free map is a word containing the byte 
count for the i-node map. It too is always even. 
I-numbers below 41(10) are reserved for special 
files, and are never allocated; the first bit in 
the i-node free map refers to i-number 41 • 
Therefore the byte number in the i-node mao for 
i-node i is ( i-41 )/8. It is offset ( i-41 ) (mod ' 
8) tf bits from the right; unlike the free map, a 
"o" bit indicates an available i-node. 

I-numbers begin at 1 , and the storage for i-nodes 
begins at block 2. Also, i-nodes are 32 bytes 
long, so 16 of them fit into a block. Therefore, 
i-node i is located in block (i+3l)/l6 of the 
file system, and begins 32* ( (jl+31 ) (mod 16)) bytes 
from its start. 

There is always one file system which is always 
mounted; in standard UNIX it resides on the RF 
disk. This device is also used for swapping. 
The swap areas are at the high addresses on the 
device. It would be convenient if these ad- 
dresses did not appear in the free list, but in 
fact this is not so. Therefore a certain number 
of blocks at the top of the device appear in the 
free map, are not marked free, yet do not appear 
within any file. These are the blocks that show 
up "missing'" in a check of the RF disk. 

Again on the primary file system device, there 
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are several pieces of information following that 
previously discussed. They contain basically the 
information typed by the tm command; namely, the 
times spent since a cold boot in various ca- 
tegories, and a count of I/O errors. In particu- 
lar, there are two words with the calendar time 
(measured since 00:00 Jan 1, 1971); two words 
with the time spent executing in the system; two 
words with the time spent waiting for I/O on the 
RF and RK disks; two words with the time spent 
executing in a user's core; one byte with the 
count of errors on the RF disk; and one byte with 
the count of errors on the RK disk. All the 
times are measured in sixtieths of a second. 

I-node 41(10) is reserved for the root directory 
of the file system. No i-numbers other than this 
one and those from 1 to 40 (which represent spe- 
cial files) have a built-in meaning. Each i-node 
represents one file. The format of an i-node is 
as follows, where the left column represents the 
offset from the beginning of the i-node: 

0-1 flags (see below) 

2 number of links 

3 user ID of owner 
4-5 size in bytes 

6-7 first indirect block or contents block 

• • • 

20-21 eighth indirect block or contents block 

22-25 creation time 

26-29 modification time 

30-31 unused 

The flags are as follows: 

100000 i-node is allocated 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040. set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 
000002 read, non-owner 
000001 write, non-owner 

The allocated bit (flag 100000) is believed even 
if the i-node map says the i-node is free; thus 
corruption of the map may cause i-nodes to become 
unallocatable, but will not cause active nodes to 
be reused. 

Byte number n of a file is accessed as follows: n 
is divided by 51 2 to find its logical block 
number (say b) in the file. If the file is small 
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OWNER 



(flag 010000 is 0), then b must be less than 8, 
and the physical block number corresponding to b 
is the bth entry in the address portion of the 
i-node. 

If the file is large, b is divided by 256 to 
yield a number which must be less than 8 (or the 
file is too large for UNIX to handle). The 
corresDonding slot in the i-node address portion 
gives the physical block number of an indirect 
block. The residue mod 256 of b is multiplied by 
two (to give a byte offset in the indirect block) 
and the word found there is the physical address 
of the block corresponding to b. 

If block b in a file exists, it is not necessary 
that all blocks less than b exist, A zero block 
number either in the address words of the i-node 
or in an indirect block indicates that the 
corresponding block has never been allocated. 
Such a missing block reads as if it contained all 
zero words. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



format of directories 



Two blocks are not enough to handle the i- and 
free-storage maps for an RP02 disk pack, which 
contains around 10 million words. 
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NAME 

SYNOPSIS 

DESCRIPTION 



ident — IDENT card file 



ident is a file used to generate GECOS slDENT 
cards by the off-line print program opr(l). 
There is one entry per line in the following 
style: 

05 :m1 234 t m789 f name 

which causes the following sIDENT card to be 
generated : 

s IDENT ml 234,m789,name 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



kept in /etc/ident. 
opr(l) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



passwd — password file 



passwd contains for each user the following 
information: 

name (login name) 
password 

numerical user ID 
default working directory 
program to use as Shell 

This is an ASCII file. Each field within each 
user's entry is separated from the next by a 
colon. Each user is separated from the next by a 
new-line. If the password field is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 

This file, naturally, is inaccessible to anyone 
but the super-user. 

This file resides in directory /etc. 



/etc/init 



super-user 
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NAME 

SYNOPSIS 

DESCRIPTION 



tap — DEC/mag tape formats 



The DECtape command tap and the magtape command 
mt dump and extract files to and from their 
respective tape media. The format of these tapes 
are the same. 

Block zero of the tape is not used. It is avail- 
able as a boot program to be used in a stand 
alone enviornment. This has proved valuable for 
DEC diagnostic programs. 

Blocks 1 thru 24 contain a directory of the tape. 
There are 192 entries in the directory; 8 entries 
per block; 64 bytes per entry. Each entry has 
the following format: 



path name 


32 bytes 


mode 


1 byte 


uid 


1 byte 


size 


2 bytes 


time modified 


4 bytes 


tape address 


2 bytes 


unused 


20 bytes 


check sum 


2 bytes 



The path name entry is the path name of the file 
when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at 
most 32 bytes long and ends in a null byte. 
Mode, uid, size and time modified are the same as 
described under inodes (see file system (V)) The 
tape address is the tape block number of the 
start of the contents of the file. Every file 
starts on a block boundary. The file occupies 
( size+51 1 )/51 2 blocks of continuous tape. The 
checksum entry has a value such that the sum of 
the 32 words of the directory is zero. 

Blocks 25 on are available for file storage. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



A fake entry (see mt(l), tap(l)) has a size of 
zero. 



f ilesystem(v) , mt(l), tap(l) 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/etc/uids — map user names to user IDs 



This file allows programs to map user names into 
user numbers and vice versa. Anyone can read it. 
It resides in directory /etc, and should be up- 
dated along with the password file when a user is 
added or deleted. 

The format is an ASCII name, followed by a colon, 
followed by a decimal ASCII user ID number. 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/tmp/utmp — user information 



This file allows one to discover information 
about who is currently using UNIX, The file is 
binary; each entry is 16(10) bytes long. The 
first eight bytes contain a user's login name or 
are null if the table slot is unused. The low 
order byte of the next word contains the last 
character of a typewriter name (currently, '0' to 
'5' for /dev/ttyO to /dev/tty5). The next two 
words contain the user's login time. The last 
word is unused. 

This file resides in directory /tmp. 



/etc/init, which maintains the file. 



ken, dmr 



- 1 - 



3/15/72 



WTMP (V) 



NAME 

SYNOPSIS 

DESCRIPTION 



/trnp/wtmp 



user login history 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



This file records all logins and logouts. Its 
format is exactly like utmp(v) except that a null 
user name indicates a logout on the associated 
typewriter, and the typewriter name 'x' indicates 
that UNIX was rebooted at that point. 

Wtmp is maintained by login(l) and init(VIl). 
Neither of these programs creates the file, so if 
it is removed record-keeping is turned off. 



init(VIl), logln(l), tacct(l), acct(l) 



ken, dmr 



- 1 - 



3/15/72 



BASIC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



basic — DEC supplied BASIC 

basic [file] 

Basic is the standard BASIC V000 distributed as a 
stand alone program. The optional file argument 
is read before the console. See DEC-1 1 -AJPB-D 
manual. 

Since bas is smaller and faster, b asic is not 
maintained on line. 



FILES 


— — 


SEE ALSO 


bas 


DIAGNOSTICS 


See manual 


BUGS 


GOK 


OWNER 


dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 

DIAGNOSTICS 
BUGS 

OWNER 



be — B interpreter 
]2£ C z£ "i sf ile lJL b , 



ofile 



be is the UNIX B interpreter. It accepts three 
types of arguments: 

Arguments whose names end with ",b" are assumed 
to be B source programs; they are compiled, and 
the object program is left on the file sfile^.o 
(i.e. w the file whose name^is^that of the source 
with ",o" substituted for ".b"*). 

Other arguments (except for "-c") are assumed to 
be either loader flag arguments, or B-compatible 
object programs, typically produced by an earlier 
be run, or perhaps libraries of B-compatible 
routines. These programs, together with the 
results of any compilations specified, are loaded 
(in the order given) to produce an executable 
program with name a, out . 

The "-c" argument suppresses the loading phase, 
as does any syntax error in any of the routines 
being compiled. 

The language itself is described in [1], 

The future if B is uncertain. The language has 
been totally eclipsed by the newer, more power- 
ful, more compact, and faster language C. 



f ile.b 

a. out 

b.tmpl 

b.tmp2 

/usr/lang/bdir/b [ca] 

/usr/lang/bdir/brt [1 2] 

/usr/lib/libb.a 

/usr/lang/bdir/bilib. a 



input file 
loaded output 
temporary (deleted) 
temporary (deleted) 
translator 

runtime initialization 
builtin functions, etc. 
interpreter library 



[1] K. Thompson; MM-72-1 271-1 ; Users' Reference 

to B. 

c(l) 

see [1] • 

Certain external initializations are illegal. 
(In particular: strings and addresses of exter- 
nals. ) 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



bj — the game of black jack 

/usr/games/bj 

Black jack is a serious attempt at simulating the 
dealer in the game of black jack (or twenty-one) 
as might be found in Reno, 

The following rules apply: 

The bet is $2 every hand. 

A player 'natural* (black jack) pays $3, A 
dealer natural loses $2. Both dealer and 
player naturals is a 'push' (no money ex- 
change ) • 

If the dealer has an ace up, the player is 
allowed to make an 'insurance' bet against the 
chance of a dealer natural. If this bet is 
not taken, play resumes as normal. If the bet 
is taken, it is a side bet where the player 
wins $2 if the dealer has a natural and loses 
$1 if the dealer does not. 

If the player is dealt two cards of the same 
value, he is allowed to 'double'. He is al- 
lowed to play two hands, each with one of 
these cards. (The bet is doubled also; $2 on 
each hand. ) 

If a dealt hand has a total of ten or eleven, 
the player may 'double down'. He may double 
the bet ($2 to $4) and receive exactly one 
more card on that hand. 

Under normal play, the player may 'hit' (draw 
a card) as long as his total is not over 
twenty-one. If the player 'busts' (goes over 
twenty-one), the dealer wins the bet. 

When the player 'stands' (decides not to hit), 
the dealer hits until he attains a total of 
seventeen or more. If the dealer busts, the 
player wins the bet. 

If both player and dealer stand, the one with 
the largest total wins. A tie is a push. 

The machine deals and keeps score. The following 
questions will be asked at appropriate times. 
Each question is answered by y, followed by a new 
line for 'yes', or just new line for 'no'. 

? means 'do you want a hit?' 
Insureance? 
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Double down? 

Every time the deck is shuffled, the dealer so 
states and the 'action' (total bet) and 'stand- 
ing' (total won or loss) is printed. To exit, 
hit the interrupt key (DEL) and the action and 
standing will be printed. 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME cal — print calendar 

SYNOPSIS /usr/ken/cal year 

DESCRIPTION Cal will print a calendar for the given year. 

The year can be between (really 1 BC) and 9999. 
For years when several calendars were in vogue in 
different countries, the calendar of England (and 
therefore her colonies) is printed, 

P,S, try cal of 1752, 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



chash — precoropile a hash table for cref 

chash filel file2 

CHASH takes symbols (character sequences; one per 
line) from filel and compiles a hash table for 
the use of cref . The table is written on file2. 

A subroutine suitable for searching such a hash 
table is available from the author. 



cref 



There can only be 199 symbols; they may total 
only 600 characters of text, 

lem 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 



cref — make cross reference listing 

cref [ -soi ] namel . . . 

CREF makes a cross reference listing of files in 
assembler format (see AS(l)). The files named as 
arguments in the command line are searched for 
symbols (defined as a succession of alphabet ics, 
numerics, '.', or '_', beginning with an alpha- 
betic, ' . ' , or '_' ) . 

The output report is in four columns: 



(1) (2) 
symbol file 



(3.) 
see 
below 



(4) 

text as it appears in file 



The third column contains the line number in the 
file by default; the ^s option will cause the 
most recent name symbol to appear there instead. 

CREF uses either an ignore file or an only file. 
If the ^i option is given, it will take the next 
file name to be an ignore file; if the ^o option 
is given, the next file name will be taken as an 
only file. Either ignore or only files must be 
made by chash (q.v.T. If an ignore file is 
given, all the symbols in the file will be ig- 
nored in columns (1) and (3) of the output. If 
an only file is given, only symbols appearing in 
the file will appear in column (1), but column 
(3) will still contain the most recent name en- 
countered. Only one of the options zl or z9. ma Y 
be used. The default setting is ^i; all symbols 
predefined in the assembler are ignored, except 
system call names, which are collected. 

Files t.O, t.1, t,2, t.3 are created (i.e. 
DESTROYED) in the working directory of anyone 
using cref . This nuisance will be repaired soon. 
The output is left in file s,out in the working 
directory. 

/usr/lem/s.tab is the default ignore file. 

chash(Vl); as(l) 

"line too long" — input line >1 31 characters 

"symbol too long" — symbol >20 characters 

"too many symbols" — >10 symbols in line 

"cannot open t.?" — bug; see author 
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"cannot fork; examine t.out" — can't start sort 
process; intermediate results are on files 
t.O , t.1 t t,2 . t. 3 . These may be sorted in- 
dependently and the results concatenated by 
the user, 

"cannot sort" — odd response from sort ; examine 
intermediate results, as above, 

impossible situation" — system bug 

cannot open" file — one of the input names 
cannot be opened for reading, 

BUGS The destruction of unsuspecting users' files 

should soon be fixed, A limitation that may 
eventually go away is the restriction to assem- 
bler language format. There should be options for 
FORTRAN, English, etc., lexical analysis. 

File names longer than eight characters cause 
misalignment in the output if tabs are set at 
every eigth column. 

OWNER lem 
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NAME das — disassembler 

SYNOPSIS 

DESCRIPTION A PDP-11 disassembler exists. Contact the owner 

for more in format ion • 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME dli — load DEC binary paper tapes 

SYNOPSIS dli output [input] 

DESCRIPTION dli will load a DEC binary paper tape into the 

output file. The binary format paper tape is 
read from the input file (/dev/ppt is default.) 

FILES /dev/ppt 

SEE ALSO 

DIAGNOSTICS "checksum" 

BUGS 

OWNER dmr 



- 1 - 



3/15/72 



DPT (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



dpt — read DEC ASCII paper tape 

dpt output [input] 

dpt reads the input file (/dev/ppt default) as- 
suming the format is a DEC generated ASCII paper 
tape of an assembly language program. The output 
is a UNIX ASCII assembly program. 

/dev/ppt 



Almost always a hand pass is required to get a 
correct output. 

ken f dmr 
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NAME moo — a game 

SYNOPSIS /usr/games/moo 

DESCRIPTION moo is a guessing game imported from England. 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME ptx — permuted index 

SYNOPSIS ptxl input tempi 

sort tempi temp2 
ptx 2 temp2 output 

DESCRIPTION ptx generates a permuted index from file input on 

file output . It is in two pieces: the first does 
the permutation, generating one line for each 
keyword in an input line. The keyword is rotated 
to the front. The permuted file must then be 
sorted. ptx2 then rotates each line around the 
middle of the page. 

input should be edited to remove useless lines. 
The following words are suppressed: "a", "and", 

•t tt ft tt *» •• tt tt ft - 1 - *■ it ft ft ft * tt ft ft 

tf as w , is , for , of , on , or , the f to f 

"up". 

The index for this manual was generated using 
£tx* 

FILES 

SEE ALSO sort 

DIAGNOSTICS 

BUGS 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



tmg — compiler compiler 

tmcf name 

tmcr produces a translator for the language whose 
syntactic and translation rules are described in 
file name.t. The new translator appears in a, out 
and may be used thus: 

a. out input [ output ] 

Except in rare cases input must be a randomly 
addressable file. If no output file is speci- 
fied, the standard output file is assumed. 

The tmg language is described in (Reference). 

/etc/tmg — the compiler-compiler 
/etc/tmga,/etc/tmgb,/etc/tmgc — libraries 
/etc/tmgO.s — global definitions 



??? — illegal input, offending line follows 

fatal error codes, appear in tmg and a. out: 

ad — address out of bounds 

so — stack overflow 

ga — address out of bounds while generating 

ko — too much parse without output 

to — symbol table overflow 

gn — getnam on symbol not in table 

co — character string overflow 



BUGS 
OWNER 



doug 
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NAME ttt — tic-tac-toe 

SYNOPSIS /usr/games/ttt 

DESCRIPTION ttt is the X's and O's game popular in 1st grade. 

This is a learning program that never makes the 
same mistake twice. 

FILES ttt.k — old mistakes 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



ascii — map of ASCII character set 

cat /usr /pub/ ascii 

ascii is a map of the ASCII character set, to be 
printed as needed. It contains: 



1 000 


nul 


001 


soh 


002 


stx 


003 


etx 


004 


eot 


005 


enq 


006 


acki 


007 


bel 


J010 


bs 


|011 


ht 


012 


nl 


013 


vt 


014 


np 


015 


cr 


016 


so 


017 


si 


J020 


die 


[021 


dd 


022 


dc2 


023 


dc3 


024 


dc4 


025 


nak 


026 


syn 


027 


etb 


J030 


can 


031 


em 


032 


subj 


033 


esc 


034 


fs 


035 


gs 


036 


rs 


037 


us 


J040 


sp 


|041 


! 


042 


tf 


043 


# 


044 


$ 


045 


% 


046 


& 


047 





J050 


( 


[051 


) 


052 


* 


053 


+ 


054 


9 


055 


— 


056 


• 


057 


/ 


J060 





|061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


1 


}070 


8 


|071 


9 


072 


• 

• 


073 


• 

9 


074 


< 


075 


= 


076 


> 


077 


1 


| 100 


@ 


| 101 


A 


102 


B 


103 


c 


104 


D 


105 


E 


106 


F 


107 


G 


| 110 


H 


| 111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 





| 120 


P 


| 12 1 


Q 


122 


R 


|123 


S 


124 


T 


125 


U 


126 


V 


127 


W 


j 130 


X 


| 131 


Y 


132 


Z 


!133 


[ 


134 


\ 


135 


] 


136 




137 




j 140 


* 


[141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


146 


f 


147 


g 


j 150 


h 


[151 
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BOOT PROCEDURES (VII ) 



NAME bos, maki, rom, vcboot, msys, et al 

SYNOPSIS 



DESCRIPTION 



On the RF disk, the highest 16K words are 
reserved for stand-alone programs. These 16K 
words are allocated as follows: 



bos 


(1K) 


Warm UNIX 


(7K) 


Cold UNIX 


(8K) 



The UNIX read only memory (ROM) is home cut with 
2 programs of 16 words each. The first (address 
173000) reads bos from the RF disk into core 
location 154000 and transfers to 154000. The 
other ROM program (address 173040) reads a 
DECtape sitting in the end-zone on drive into 
core location and transfers to 0. This latter 
operation is compatible with part of DEC's stan- 
dard ROM. The disassembled code for the UNIX ROM 
f ol lows : 



12700; 177472 

12740; 3 

12 740; 140000 

12740; 154000 

12740; 176000 

12740; 5 

105710 

2376 

137; 154000 

12700; 177350 

5040 

10040 

12740; 3 

105710 

2 376 

5737;177350 

1377 

112710;5 

105710 

2376 

5007 



The program bos (Bootstrap operating System) 
examines the console switchs and executes one of 
several internal programs depending on the set- 
ting. The following settings are currently 
recognized: 

??? Will read Warm UNIX from the RF into core 

location and transfer to 600. 

1 Will read Cold UNIX from the RF into core 
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173000: mov 


$177472, rO 


mov 


$3,-(r0) 


mov 


$1 40000, -(r0) 


mov 


$154000,-(r0) 


mov 


$-2000, -(r0) 


mov 


$5,-(r0) 


tstb 


(r0) 


bge 


.-2 


jmp 


*$ 154000 


173040: mov 


$177350, rO 


clr 


-(r0) 


mov 


r0,-(r0) 


mov 


$3,-(r0) 


tstb 


(rO) 


bge 


.-2 


tst 


*$177350 


bne 


• 


movb 


$5,(r0) 


tstb 


(rO) 


bge 


• -2 


clr 


pc 
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location and transfer to 600. 

10 Will dump all of memory from core loca- 

tion onto DECtape drive 7 and then 
halt. 

20 Will read 2 56 words from RKO into core 

and transfer to zero. This is the pro- 
cedure to boot DOS from an RK. 

40 This is the same as 10 above, but instead 

of halting, UNIX warm is loaded. 

Will load a standard UNIX binary paper 

tape into core location and transfer to 
0. 

77500 Will load the standard DEC absolute and 
binary loaders and transfer to 77500. 

Thus we come to the UNIX warm boot procedure: put 
173000 into the switches, push load address and 
then push start . The alternate switch setting of 
173030 that will load warm UNIX is used as a sig- 
nal to bring up a single user system for special 
purposes. See init(VII). For systems without a 
rom, UNIX (both warm and cold) have a copy of the 
disk boot program at location 602. This is prob- 
ably a better warm boot procedure because the 
program at 602 also attempts to complete out- 
standing I/O. 

Cold boots can be accomplished with the Cold UNIX 
program, but they're not. Thus the Cold UNIX 
slot on the RF may have any program desired. 
This slot is, however, used during a cold boot. 
Mount the UNIX INIT DECtape on drive positioned 
in the end -zone. Put 173040 into the switches. 
Push load address . ' Put 1 into the switches. 
Push st art T This reads a program called vcboot 
from the tape into core location and transfers 
to it. vcboot then reads 16k words from the 
DECtape (blocks 1-32) and copies the data to the 
highest 16K words of the RF. Thus this initial- 
izes the read-only part of the RF. vcboot then 
reads in bos and executes it. bos then reads in 
Cold UNIX and executes that. Cold UNIX halts for 
a last chance before it completely initializes 
the RF file system. Push continue , and Cold UNIX 
will initialize the RF. It then sets into execu- 
tion a user program that reads the DECtape for 
initialization files starting from block 33. 
When this is done, the program executes /etc/init 
which should have been on the tape. 

The INIT tape is made by the program maki running 
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BOOT PROCEDURES (VII) 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



under UNIX, maki writes vcboot on block of 
/d ev / t ap7 . It then copies the RF 16K words 
(using / dev/rfO ) onto blocks 1 thru 32. It has 
internally a list of files to be copied from 
block 33 on. This list follows: 

/etc/init 

/bin/chmod 

/bin/date 

/bin/login 

/bin/Is 

/bin/mkdir 

/etc/mount 

/bin/sh 

/bin/tap 

Thus this is the set of programs available after 
a cold boot. init and jsh are mandatory. For 
multi-user UNIX, getty and login are also neces- 
sary, mkdir is necessary due to a bug in tap . 
tap and mount are useful to bring in new files. 
As soon as possible, date should be done. That 
leaves l_s and chmod as frosting. 

The last link in this incestuous daisy chain is 
the program msys . 

msys char file 

will copy the file file onto the RF read only 
slot specified by the characacter char . Char is 
taken from the following set: 

b bos 

u Warm UNIX 

J. Gold UNIX 

Due to their rarity of use, maki and msys are 
maintained off line and must be reassembled be- 
fore used. 

/dev/rfO, /dev/tap? 

init(VIl), tap(l), sh(l), mkdir(l) 



This section is very configuration dependent. 
Thus, it does not describe the boot procedure for 
any one machine. 

ken 
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GETTY (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



getty — set typewriter mode and get user's name 



crettv is invoked by init (VII ) immediately after 
a typewriter is opened following a dial-in. The 
user's login name is read and the login(l) com- 
mand is called with this name as an argument. 
While reading this name getty attempts to adapt 
the system to the speed and type of terminal 
being used. 

getty initially sets the speed of the interface 
to 150 baud, specifies that raw mode is to be 
used (break on every character), that echo is to 
be suppressed, and either parity allowed. It 
types the "login: " message (which includes the 
characters which put the 37 Teletype terminal 
into full-duplex and unlock its keyboard). Then 
the user's name is read, a character at a time. 
If a null character is received, it is^assumed to 
be the result of the user pushing the "break*" 
("interrupt") key. The speed is then changed to 
300 baud and the "logins" is typed again, this 
time with the appropriate sequence which puts a 
GE TermiNet 300 into full-duplex. This sequence 
is acceptable to other 300 baud terminals also. 
If a subsequent null character is received, the 
speed is changed again. The general approach is 
to cycle through a set of speeds in response to 
null characters caused by breaks. The sequence 
at this installation is 150, 300, and 134.5 baud. 

Detection of IBM 2741s is accomplished while the 
speed is set to 150 baud. The user sends a 2741 
style "eot" character by pushing the attention 
key or by typing return; at w £50 baud, this char- 
acter looks like the ascii "~" (174-). Upon' 
receipt of the "eot" A the system is set to 
operate 2741s and a login: " message is typed. 

The user's name is terminated by a new-line or 
carriage-return character. The latter results in 
the system being set to to treat carriage returns 
appropriately (see stty(ll)). 

The user's name is scanned to see if it contains 
any lower-case alphabetic characters; if not, the 
system is told to map any future upper-case char- 
acters into the corresponding lower-case charac- 
ters. Thus UNIX is usable from upper-case— only 
terminals. 

Finally, login is called with the user's name as 
argument. 
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FILES /etc/getty 

SEE ALSO init(VIl), login(l), stty(ll) 

DIAGNOSTICS 

BUGS 

OWNER dmr, ken, jfo 
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GLOB (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



glob — generate command arguments 



glob is used to expand arguments to the shell 
containing "*" , '[', or "?". It is passed the 
argument list containing the metacharacters; glob 
expands the list and calls the command itself • 

found in /etc/glob 

sh(l) 

"No match", "No command", "no directory" 



If any of 



'[', or '?' occurs both quoted and 



OWNER 



unquoted in the original command line, even the 
quoted metacharacters are expanded, 

glob gives the "No match" diagnostic only if no 
arguments at all result. This is never the case 
if there is any argument without a metacharacter. 

dmr 
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INIT (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



init — process control initialization 



init is invoked inside UNIX as the last step in 
the boot procedure. Generally its role is to 
create a process for each typewriter on which a 
user may log in. 

First, init checks to see if the console switches 
contain 173030. (This number is likely to vary 
between systems. ) If so, the console typewriter 
ttv is opened for reading and writing and the 
shell is invoked immediately. This feature is 
used to bring up a test system, or one which does 
not contain DC-1 1 communications interfaces. 
When the system is brought up in this way, the 
getty and login routines mentioned below and 
described elsewhere are not needed. 

Otherwise, init does some housekeeping: the mode 
of each DECtape file is changed to 17 (in case 
the system crashed during a tap command); direc- 
tory /usr is mounted on the RKO disk; directory 
/sys is mounted on the RK1 disk. Also a data- 
phone daemon is spawned to restart any jobs being 
sent. 

Then init forks several times to create a process 
for each typewriter mentioned in an internal 
table. Each of these processes opens the ap- 
propriate typewriter for reading and writing. 
These channels thus receive file descriptors 
and 1, the standard input and output. Opening 
the typewriter will usually involve a delay, 
since the open is not completed until someone is 
dialled in ( and carrier established) on the chan- 
nel. Then the process executes the program 
/etc/getty (q.v.). getty will read the user's 
name and invoke login (q.v. ) to log in the user 
and execute the shell. 

Ultimately the shell will terminate because of an 
end-of-f ile either typed explicitly or generated 
as a result of hanging up. The main path of 
init, which has been waiting for such an event, 
wakes up and removes the appropriate entry from 
the file utmp . which records current users, and 
makes an entry in wtmp . which maintains a history 
of logins and logouts. Then the appropriate 
typewriter is reopened and getty reinvoked. 

kept in /etc/in it; uses /dev/tap, /dev/tty, 
/dev/tty?, /tmp/utmp, /tmp/wtmp 

login(l), login (VII), getty(VIl), sh(l), dpd(l) 
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DIAGNOSTICS none possible 

BUGS none possible 

OWNER ken, dmr 
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KBD (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



kbd — keyboard map 

cat /usr/pub/kbd 

kbd contains a map to the keyboard for model 37 
Teletype terminals with the extended character 
set feature. If kbd is printed on such a termi- 
nal, the following will appear: 

<[1234567890-J~\ >qwertyuiop@ asdfghjkl;: zxcvbnm,./ 

<V1 234567890— &J*Y > v ;: ,./ 

<{!"#$%&'() =_}~ >QWERTYUIOP % ASDFGHJKL+* ZXCVBNM,.? 

< !"#$%&*() =- >£AA^e<y(pren aes$r¥*px+* n^cDypiiu,.? 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



jfo 
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LOGIN, LOGOUT (VII ) 



NAME 

SYNOPSIS 

DESCRIPTION 



logging in and logging out 



UNIX must be called from an appropriate terminal. 
UNIX supports ASCII terminals typified by the 
Teletype M37, the GE Terminet 300, the Memorex 
1240, and various graphical terminals on the one 
hand, and IBM 2741 -type terminals on the other. 

Not all installations support all these termi- 
nals. Often the M33/35 Teletype is supported 
instead of the 2741. Depending on the hardware 
installed, most terminals operating at 110, 
134.5, 150, or 300 baud can be accommodated. 

To use UNIX, it is also necessary to have a valid 
UNIX user ID and (if desired) password. These 
may be obtained, together with the telephone 
number, from the system administrators. 

The same telephone number serves terminals 
operating at all the standard speeds. The dis- 
cussion below applies when the standard speeds of 
134.5 (2741 's) 150 (TTY 37's) and 300 (Terminet 
300' s) are available. 

When a connection is established via a w 150-baud 
terminal (e.g. TTY 37) UNIX types out "login;"; 
you respond with your user name, and, if request- 
ed, with a password. (The printer is turned off 
while you type the pas sword. ) If the login was 
successful, the "@" character is typed by the 
Shell to indicate login is complete and commands 
may be issued. A message of the day may be typed 
if there are any announcements. Also, if there 
is a file called "mailbox", you are notified that 
someone has sent you mail. (See the mail com- 
mand. ) 

From a 300-baud terminal, the procedure is 
slightly different. Such terminals often have a 
full-duplex switch, which should be turned on (or 
conversely, half-duplex should be turned off). 
When a connection with UNIX is established, a few 
garbage^ characters are typed (these are the 

login:"* message at the wrong speed). You should 
depress the "break" key; this is a speed- 
independent signal to UNIX that a 300-baud termi- 
nal is in use. It will type "login:" (at the 
correct speed this time) and from then on the 
procedure is the same as described above. 

From a 2741 , no message will appear. After the 
telephone connection is established, press the 
"ATTN" button. UNIX should type "login:" as 
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FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OWNER 



described above. If the greeting does not appear 
after a few seconds, hang up and try again; some- 
thing has gone wrong* If a password is required, 
the printer cannot be turned off, so it will 
appear on the paper when you type it. 

For more information, consult getty(VIl), which 
discusses the login sequence in more detail, and 
ttyO(lV), which discusses typewriter I/O. 

Logging out is simple by comparison (in fact, 
sometimes too simple). Simply generate an end- 
of-file at Shell level^by using the EOT 
character; the "login: " message will appear again 
to indicate that you may log in again. 

It is also possible to log out simply by hanging 
up the terminal; this simulates an end-of-file on 
the typewriter. 

/etc/motd may contain a message-of-the-day. 

init(VIl), getty(VIl), ttyO(lV) 



Hanging up on programs which never read the type- 
writer or which ignore end-of-files is very 
dangerous; in the worst cases, the programs can 
only be halted by restarting the system. 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



msh — mini-shell 



msh is a heavily simplified version of the Shell. 
It reads one line from the standard input file, 
interprets it as a command, and calls the com- 
mand. 

The mini-shell -supports few of the advanced 
features of the Shell; none of the following 
characters is special: 

> < $ \ ; & 

However, w * w , "[**, and "?'" are recognized and 
glob is called. The main use of msh is to pro- 
vide a command-executing facility for various 
interactive sub-systems. 

found in /etc/msh 

sh, glob 



ken , dmr 
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NAME tabs — tab stop set 

SYNOPSIS cat /usr/pub/tabs 

DESCRIPTION When printed on a suitable terminal, this file 

will set tab stops at columns 8, 16, 24, 32, •••• 
Suitable terminals include the Teletype model 37 
and the GE TermiNet 300. 

These tabs stop settings are desirable because 
UNIX assumes them in calculating delays. 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 



- 1 - 



